home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 008 / drawman.arc / DRAWMAN.DOC next >
Text File  |  1986-10-18  |  141KB  |  3,433 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                       
  8.                         User Manual for The Draftsman
  9.                                  Version 1.0
  10.                                        
  11.  
  12.                                  Prepared by
  13.  
  14.                             David J. Stang, Ph.D.
  15.                                       
  16.                                 Hire Education
  17.                                       
  18.                              3631 Jenifer St. NW
  19.                              Washington DC 20015
  20.  
  21.                             (202) 966-1635 (voice)
  22.                              (202) 686-5360 (BBS)
  23.  
  24.  
  25.                               September 1, 1985
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72. User Manual for The Draftsman 
  73. ______________________________________________________________________________
  74.  
  75.  
  76.  
  77.  
  78.                               TABLE OF CONTENTS
  79.  
  80.  
  81. 1. Features of The Draftsman ..............................................  1
  82.  
  83. 2. Using Help .............................................................  1
  84.  
  85. 3. General Overview .......................................................  2
  86.    3.1 Constructing a Graph ...............................................  2
  87.    3.2 Menus ..............................................................  3
  88.    3.3 Cursor Motion Keys .................................................  3
  89.    3.4 Field Editing Keys .................................................  4
  90.    3.5 Some General Notes on Menus ........................................  4
  91.    3.6 The Main Menu ......................................................  5
  92.  
  93. 4. Define Environment .....................................................  6
  94.  
  95. 5. Specify Input ..........................................................  7
  96.    5.1 Source of Data .....................................................  8
  97.       5.1.1 Edit ..........................................................  8
  98.       5.1.2 DIF ...........................................................  9
  99.       5.1.3 DATA ..........................................................  9
  100.    5.2 File Number ........................................................ 10
  101.    5.3 Number of x Values, Number of y Values for Each x Value ............ 10
  102.    5.4 Modify Existing File Size? ......................................... 11
  103.    5.5 Name of File ....................................................... 11
  104.    5.6 Edit:Filen ......................................................... 11
  105.    5.7 Graphing Values from 1-2-3 ......................................... 12
  106.  
  107. 6. General Plot Specifications ............................................ 12
  108.  
  109. 7. Pie Chart Specifications ............................................... 14
  110.    7.1 Title and Footnote Fields .......................................... 15
  111.    7.2 Explode ............................................................ 15
  112.    7.3 Pie Colors ......................................................... 15
  113.    7.4 Data File .......................................................... 15
  114.    7.5 Y column ........................................................... 15
  115.    7.6 Chart Size and Position (boxing) ................................... 15
  116.  
  117. 8. Bar Chart Specifications ............................................... 16
  118.    8.1 Title, Footnote .................................................... 17
  119.    8.2 X-label ............................................................ 17
  120.    8.3 Y-label ............................................................ 17
  121.    8.4 Bar Colors ......................................................... 17
  122.    8.5 Bar Format ......................................................... 17
  123.    8.6 Enclose Chart in Box ............................................... 17
  124.    8.7 Horizontal Reference Value ......................................... 18
  125.    8.8 Baseline Value ..................................................... 18
  126.    8.9 Data File .......................................................... 18
  127.    8.10 Y-columns ......................................................... 18
  128.    8.11 Minimum Column Width .............................................. 18
  129.  
  130.  
  131. ______________________________________________________________________________
  132. (c) 1985 by David J. Stang                                   Please Reproduce!
  133.  
  134.  
  135.  
  136.  
  137.  
  138. User Manual for The Draftsman 
  139. ______________________________________________________________________________
  140.  
  141.  
  142.  
  143.  
  144.    8.12 Chart Size and Position ........................................... 18
  145.  
  146. 9. Line Graph Specifications .............................................. 18
  147.    9.1 Line Markers ....................................................... 19
  148.    9.2 Connect Points ..................................................... 20
  149.  
  150. 10. Edit .................................................................. 20
  151.    10.1 Add Text .......................................................... 21
  152.    10.2 Get Help .......................................................... 21
  153.    10.3 Leave Edit ........................................................ 21
  154.    10.4 Place a Dot ....................................................... 21
  155.    10.5 Draw a Line ....................................................... 21
  156.    10.6 Draw an Arrow ..................................................... 21
  157.    10.7 Move .............................................................. 21
  158.    10.8 Find Out Where You Are ............................................ 21
  159.    10.9 Execute Saved Edit Commands ....................................... 22
  160.    10.10 Write Your Name in Longhand ...................................... 22
  161.    10.11 Change Color ..................................................... 22
  162.    10.12 Draw a Rectangle ................................................. 22
  163.    10.13 Add a Legend ..................................................... 23
  164.    10.14 Draw a Circle (or Oval) .......................................... 23
  165.    10.15 Back Up your Screen to Disk ...................................... 23
  166.    10.16 Retrieve a Screen from Disk ...................................... 23
  167.    10.17 Paint a Region ................................................... 23
  168.    10.18 Draw a Flowchart ................................................. 24
  169.    10.19 Erase a Line ..................................................... 24
  170.    10.20 Erase a Region ................................................... 24
  171.    10.21 Move a Section of the Plot to a Different Location ............... 24
  172.  
  173. 11. Produce Hard Copy Output .............................................. 24
  174.    11.1 Epson ............................................................. 25
  175.       11.1.1 Print Aspect Ratio ........................................... 25
  176.       11.1.2 Orientation .................................................. 25
  177.    11.2 HP-7470 ........................................................... 26
  178.       11.2.1 Input ........................................................ 26
  179.       11.2.2 Retrieving Saved Plots ....................................... 26
  180.       11.2.3 Switch Settings .............................................. 26
  181.       11.2.4 Startup ...................................................... 27
  182.       11.2.5 Restrictions and Special Features of Edit .................... 27
  183.       11.2.6 Other Differences Between Screen and Plotter Graphics ........ 27
  184.  
  185. 12. Save Screen/Data/Spec ................................................. 28
  186.    12.1 Screen ............................................................ 28
  187.    12.2 Data .............................................................. 28
  188.    12.3 Spec .............................................................. 29
  189.    12.4 Diskette File Name ................................................ 29
  190.    12.5 File Number and Format ............................................ 29
  191.  
  192. 13. Display Slide Show .................................................... 29
  193.    13.1 Time .............................................................. 30
  194.    13.2 Slide Names ....................................................... 31
  195.  
  196.  
  197. ______________________________________________________________________________
  198. (c) 1985 by David J. Stang                                   Please Reproduce!
  199.  
  200.  
  201.  
  202.  
  203.  
  204. User Manual for The Draftsman 
  205. ______________________________________________________________________________
  206.  
  207.  
  208.  
  209.  
  210.    13.3 List File Directory ............................................... 31
  211.  
  212. 14. Error Messages ........................................................ 31
  213.  
  214. 15. Installation .......................................................... 34
  215.    15.1 Equipment Required ................................................ 35
  216.    15.2 For New Computer Users Only ....................................... 35
  217.       15.2.1 Diskette Care ................................................ 35
  218.    15.3 Make a Backup Copy ................................................ 35
  219.    15.4 Invoking The Draftsman ............................................ 36
  220.    15.5 The Draftsman Files ............................................... 36
  221.    15.6 Modify FILE.DAT ................................................... 37
  222.       15.6.1 Running The Draftsman From a Floppy .......................... 37
  223.       15.6.2 Running The Draftsman from a Hard Disk ....................... 38
  224.    15.7 For Users with Monochrome Monitors ................................ 39
  225.    15.8 Assuring You Have a Full Copy of The Draftsman .................... 40
  226.    15.9 Installing a Mouse Driver ......................................... 40
  227.    15.10 HP 7470A Plotter ................................................. 40
  228.  
  229. 16. Support for Users ..................................................... 41
  230.    16.1 24-Hour BBS Support ............................................... 41
  231.    16.2 Support for Registered Users ...................................... 41
  232.    16.3 Source Code Available ............................................. 41
  233.    16.4 Distribution Conditions ........................................... 41
  234.    16.5 History of The Draftsman .......................................... 42
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263. ______________________________________________________________________________
  264. (c) 1985 by David J. Stang                                   Please Reproduce!
  265.  
  266.  
  267.  
  268.  
  269.  
  270. User Manual for The Draftsman 
  271. ______________________________________________________________________________
  272.  
  273.  
  274.  
  275.  
  276.                                 LIST OF TABLES
  277.  
  278. 1 Main Menu ...............................................................  5
  279. 2 Define Environment Menu .................................................  6
  280. 3 Specify Input Menu ......................................................  7
  281. 4 Data Entry Menu .........................................................  8
  282. 5 Sample Data File (Comma Delimited) ......................................  9
  283. 6 General Plot Specifications Menu ........................................ 12
  284. 7 Pie Chart Menu .......................................................... 14
  285. 8 Bar Chart Menu .......................................................... 16
  286. 9 Line Graph Menu ......................................................... 18
  287. 10 Edit Command Summary ................................................... 20
  288. 11 Printer/Plotter Menu ................................................... 24
  289. 12 Save Screen/Data/Spec Menu ............................................. 28
  290. 13 Slide Show Menu ........................................................ 29
  291. 14 List File Directory Menu ............................................... 31
  292. 15 FILE.DAT ............................................................... 37
  293. 16 FILE.DAT for Floppy-Based Operation .................................... 37
  294. 17 Files Required by The Draftsman ........................................ 40
  295. 18 Mouse Installation Batch File .......................................... 40
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329. ______________________________________________________________________________
  330. (c) 1985 by David J. Stang                                   Please Reproduce!
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.                                        
  339.                         User Manual for The Draftsman
  340.                                  Version 1.0
  341.                                        
  342.                                  Prepared by
  343.                             David J. Stang, Ph.D.
  344.                                Hire Education
  345.                              3631 Jenifer St. NW
  346.                              Washington DC 20015
  347.  
  348.                             (202) 966-1635 (voice)
  349.                              (202) 686-5360 (BBS)
  350.                                  ~~~~~~~~~~~~
  351.  
  352.  
  353.                         1.  Features of The Draftsman
  354.  
  355.  
  356.  1. Context-sensitive help.
  357.  
  358.  2. Stacked  and  cluster  bars, line charts, scatter charts, pie and exploded
  359.     pie charts.
  360.  
  361.  3. Free-hand edit mode, with options to draw, scale, and move rectangles  and
  362.     circles, line drawing, arrow creation.
  363.  
  364.  4. Slide show mode.
  365.  
  366.  5. Support for Mouse Systems mouse.
  367.  
  368.  6. 24-hour support via Bulletin Board.
  369.  
  370.  
  371.  
  372.                                 2.  Using Help
  373.  
  374. The information in the help menus is divided into four "chapters":
  375.  
  376.  1. Introduction.  This gives an overview of The Draftsman, and brief instruc-
  377.     tions on how to get started.
  378.  
  379.  2. Menu Descriptions. The Draftsman contains 13 menus which you use to select
  380.     graph options. This chapter has detailed instructions for filling out each
  381.     menu. If you press F1 when you are looking at a menu, you will enter  help
  382.     at the appropriate page of this chapter.
  383.  
  384.  3. Error  messages.  This chapter explains all error messages produced by The
  385.     Draftsman. If there is an error message on the screen when you  press  F1,
  386.     you will enter help at the relevant page of this chapter.
  387.  
  388.  4. Appendix. This contains instructions for installing The Draftsman.
  389.  
  390. All  of  the  information  that may be found in the context-sensitive help may
  391. also be found in this manual, although the on-screen help may be much  handier
  392.  
  393.  
  394. ______________________________________________________________________________
  395. (c) 1985 by David J. Stang                                   Please Reproduce!
  396.  
  397.  
  398.  
  399.  
  400.  
  401. User Manual for The Draftsman   Page 2
  402. ______________________________________________________________________________
  403.  
  404.  
  405.  
  406. than this manual for getting the help you need.
  407.  
  408. You  may  get  to help whenever you have a problem by pressing the F1 function
  409. key. Once you are in help, you may go directly to a  chapter,  by  typing  the
  410. chapter  number,  then F2. After reading a help page, you have four choices as
  411. to what to do next.
  412.  
  413.  1. Type + to go to the next page. This is  the  default  choice  for  reading
  414.     help; you may page forward through help simply by pressing F2 whenever you
  415.     are ready for the next page.
  416.  
  417.  2. Type - to go to the previous help page
  418.  
  419.  3. Type x to exit from help and return from whence you came
  420.  
  421.  4. Type a page number to go directly to a specific page in help. Page numbers
  422.     appear  in  the  lower  right hand corner of each page and have the format
  423.     a.b.c The instructions for menu n  begin  on  page  2.n,  so  you  can  go
  424.     straight to a menu by entering its page number below. For example, to find
  425.     out about bar charts (menu 4.2) enter page 2.4.2.
  426.  
  427. After entering your choice, press F2 (or enter).
  428.  
  429.  
  430.                              3.  General Overview
  431.  
  432. The  Draftsman presents a relatively easy and powerful way for converting data
  433. into graphic displays. Although the  emphasis  in  The  Draftsman  is  towards
  434. business  plots, it allows you to create arbitrary graphics. On the assumption
  435. that learning by doing is more efficient than learning by reading,  I  am  not
  436. going to spend a lot of time now talking about what The Draftsman can or can't
  437. do.  Instead I just want to discuss the general operation of The Draftsman and
  438. send you on your way. You should have produced your  first  graph  within  the
  439. next couple of minutes.
  440.  
  441.  
  442. 3.1  C_o_n_s_t_r_u_c_t_i_n_g_ a_ G_r_a_p_h_
  443.  
  444. The processing of creating a graph normally involves three steps:
  445.  
  446.  1. Specify  data  input: choice 3 from the MAIN MENU (this menu was the first
  447.     thing you saw when you entered The Draftsman). You've got  to  plot  some-
  448.     thing,  and  this step allows you to either key in data directly, or indi-
  449.     cate that the data is to come from an existing disk file.
  450.  
  451.  2. Create a chart: choice 4 from the main  menu.  This  step  involves  first
  452.     selecting  the type of chart (pie, bar, etc.), then providing details such
  453.     as titles, colors, labels, etc.
  454.  
  455.  3. Produce a permanent copy of the chart: choice 5. In this step the chart is
  456.     generated on either a pen plotter or a dot matrix printer.
  457.  
  458.  
  459.  
  460. ______________________________________________________________________________
  461. (c) 1985 by David J. Stang                                   Please Reproduce!
  462.  
  463.  
  464.  
  465.  
  466.  
  467. User Manual for The Draftsman   Page 3
  468. ______________________________________________________________________________
  469.  
  470.  
  471.  
  472.     3.2  M_e_n_u_s_
  473.  
  474.     If you have data to be displayed, you construct a chart by selecting among
  475.     options: what kind of chart, what color, etc. In The  Draftsman,  all  op-
  476.     tions  are  selected  via menus, where a menu consists of a number of mul-
  477.     tiple choice or fill-in questions.
  478.  
  479.     There are several common features to entering data in menus, as follows:
  480.  
  481.      1. You enter information in fields, indicated by colored rectangles. Each
  482.         menu field has a fixed length; you can't backspace out of, or move  to
  483.         the right of the box.
  484.  
  485.      2. F1 will send you to the page of help which describes the menu.
  486.  
  487.      3. F2  indicates  that you are done entering data in the menu and wish to
  488.         proceed.
  489.  
  490.      4. F3 means that you want to go back to the previous menu.
  491.  
  492.      5. Cursor motion keys and field editing keys. Throughout all  menus,  the
  493.         same  cursor  motion  and field editing keys do the same jobs. A brief
  494.         summary of cursor motion and field editing is  provided  in  the  next
  495.         section.
  496.  
  497.      6. As each field is entered, The Draftsman will check its validity. If an
  498.         error  is  detected,  a  short error message will be displayed and the
  499.         cursor will be positioned to the beginning of the same field.  If  you
  500.         need some more explanation as to why your value is wrong, press F1 for
  501.         help.
  502.  
  503.      7. When  a  menu  is  first displayed, some of the fields will already be
  504.         filled in. Feel free to change these values if you  like.  Also,  many
  505.         fields are optional and can be left blank.
  506.  
  507.  
  508.  
  509.     3.3  C_u_r_s_o_r_ M_o_t_i_o_n_ K_e_y_s_
  510.  
  511.     Cursor motion keys move the cursor from field to field:
  512.  
  513.     C_u_r_s_o_r_ D_o_w_n_.  moves you to the next field within a menu.
  514.  
  515.     E_n_t_e_r_  (R_e_t_u_r_n_).  does  the  same  job as cursor down: it moves you to the
  516.     next field in a menu.
  517.  
  518.     C_u_r_s_o_r_ U_p_.  moves you to the previous field within a menu.
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526. ______________________________________________________________________________
  527. (c) 1985 by David J. Stang                                   Please Reproduce!
  528.  
  529.  
  530.  
  531.  
  532.  
  533. User Manual for The Draftsman   Page 4
  534. ______________________________________________________________________________
  535.  
  536.  
  537.  
  538.     3.4  F_i_e_l_d_ E_d_i_t_i_n_g_ K_e_y_s_
  539.  
  540.     Field editing keys are used to enter data within fields.
  541.  
  542.     D_e_l_.  deletes a character to the right of the cursor.
  543.  
  544.     I_n_s_.  puts you in insert mode. Subsequent characters are inserted  in  the
  545.     middle of the field. Type Ins again to turn it off.
  546.  
  547.     C_t_r_l_-E_n_d_.  erases  from  the  current  cursor  position  to the end of the
  548.     field.
  549.  
  550.     C_u_r_s_o_r_ l_e_f_t_/r_i_g_h_t_.  moves the cursor within the field without changing the
  551.     data.
  552.  
  553.  
  554.     3.5  S_o_m_e_ G_e_n_e_r_a_l_ N_o_t_e_s_ o_n_ M_e_n_u_s_
  555.  
  556.     A few general notes:
  557.  
  558.      1. There are three different kinds of values which can be  entered  in  a
  559.         menu:  numbers, text (such as titles, labels), and words chosen from a
  560.         fixed set of choices. An example of the last is in menu 4,  where  you
  561.         must  enter one of pie, bar, line, edit, or erase to indicate the kind
  562.         of chart you want to make. For any  fields  for  which  the  range  of
  563.         possible  values  is limited, the choices are given in square brackets
  564.         [thus].
  565.  
  566.      2. Some menu entries allow you to enter more than one value. For example,
  567.         if you are plotting several lines in a line graph, you can indicate  a
  568.         different  color  for  each  of  the  lines. Multiple values should be
  569.         separated by commas and/or spaces.
  570.  
  571.      3. In the upper right corner of every menu, The  Draftsman  displays  the
  572.         amount  of  free computer memory. This is a workspace for storing data
  573.         files and input to menus. Each time you enter data in a menu, the free
  574.         space diminishes; it is possible to run out of memory. You  have  four
  575.         options to reduce your use of memory:
  576.  
  577.         -   use   erase   in  menu  4  to  start  with  a  new  set  of  graph
  578.         specifications.,
  579.  
  580.         - enter n in menu 2 in the field marked- save edit commands?.  Complex
  581.         editing,  particularly if it involves a lot of text, can consume a lot
  582.         of memory. (Even if the workspace is larger, you are limited to 8K  in
  583.         a single edit.)
  584.  
  585.         - use menu 6 to save your work, exit The Draftsman, and start again.
  586.  
  587.         -  increase the memory in your machine. With 128K of total memory, The
  588.         Draftsman allocates a workspace of only 4K, but with 160K or more, the
  589.         workspace expands to 32K.
  590.  
  591.  
  592. ______________________________________________________________________________
  593. (c) 1985 by David J. Stang                                   Please Reproduce!
  594.  
  595.  
  596.  
  597.  
  598.  
  599. User Manual for The Draftsman   Page 5
  600. ______________________________________________________________________________
  601.  
  602.  
  603.  
  604.     3.6  T_h_e_ M_a_i_n_ M_e_n_u_
  605.  
  606.     The main menu is your home base. You begin all tasks from  here,  and  you
  607.     will  return here after the task is completed. The main menu resembles the
  608.     figure below:
  609.  
  610.                         ---=== _T_a_b_l_e_ 1_: M_a_i_n_ M_e_n_u__ ===---
  611.                                      MAIN MENU                               Free: 32738
  612.  
  613.  
  614.  
  615.                             1  Introduction
  616.                             2  Define Environment
  617.                             3  Specify Input
  618.                             4  Create Plot
  619.                             5  Produce Hard Copy Output
  620.                             6  Save Screen/Data/Spec
  621.                             7  Display Slide Show
  622.                             8  List File Directory
  623.                             9  Exit From THE DRAFTSMAN
  624.  
  625.          Your choice:
  626.  
  627.  
  628.          Note:  This is freeware! Please share it with others.
  629.                 Send a $25 contribution to Hire Education,
  630.                 3631 Jenifer NW, Wash DC 20015
  631.  
  632.  
  633.  
  634.          TYPE:  F1 (Help!)  F2 (Entry complete. Proceed)  F3 (Return to previous menu)
  635.                 -------------------------------------------------------
  636.  
  637. Your 9 menu choices will do accomplish these things:
  638.  
  639.  1. Introduction. This will take you to the introduction in help.
  640.  
  641.  2. Define Your Environment If you choose main menu option 2, you will  be  be
  642.     given  an  opportunity  to  alter  your  graphics environment by selecting
  643.     graphics resolution,* color palette, background color, etc.
  644.  
  645.  3. Specify input. All charts need data to be plotted. This option allows  you
  646.     to either: 1) enter data directly, 2) retrieve a data file stored on disk,
  647.     or 3) edit a previously created file.
  648.  
  649.  4. Create a plot. This is where The Draftsman draws your picture.
  650.  
  651.  5. Produce  hard  copy  output.  This option will let you make a copy of your
  652.     plot on your dot matrix printer.
  653.  
  654.  6. Save Screen/Data/Spec. This choice will let  you  save  everything  you've
  655.     done.
  656.  
  657.  
  658. ______________________________________________________________________________
  659. (c) 1985 by David J. Stang                                   Please Reproduce!
  660.  
  661.  
  662.  
  663.  
  664.  
  665. User Manual for The Draftsman   Page 6
  666. ______________________________________________________________________________
  667.  
  668.  
  669.  
  670.  7. Display  slide show. This will let you display up to 20 screen images in a
  671.     rotating sequence.
  672.  
  673.  8. List file directory. Use this option to  determine  the  files  stored  on
  674.     disk. This is useful for resolving "file not found" errors.
  675.  
  676.  9. Exit from The Draftsman. Return to DOS.
  677.  
  678.  
  679.  
  680.                             4.  Define Environment
  681.  
  682. In  this  menu, you specify the graphics environment in which you operate. The
  683. menu resembles that shown in the figure below:
  684.  
  685.  
  686.                ---=== _T_a_b_l_e_ 2_: D_e_f_i_n_e_ E_n_v_i_r_o_n_m_e_n_t_ M_e_n_u__ ===---
  687.                           2.  DEFINE ENVIRONMENT                         Free: 32669
  688.  
  689.      Graphics resolution [lo,hi]:   lo
  690.  
  691.         If lo:
  692.            select palette [1,2]:    1  [palette 1: green, red, brown
  693.                                                 2: cyan, magenta, white]
  694.            background color number: 1  [choose from colors 0-7 below]
  695.  
  696.      Menu display:
  697.         foreground     text: 2    field 1: 7    field 2: 7      [colors 0-15]
  698.         background                         4             1      [colors 0-7]
  699.  
  700.      Color reference:
  701.          0.   black        4. █ red          8.   hi-black    12. █ hi-red
  702.          1. █ blue         5. █ magenta      9. █ hi-blue     13. █ hi-magenta
  703.          2. █ green        6. █ yellow      10. █ hi-green    14. █ hi-yellow
  704.          3. █ cyan         7. █ white       11. █ hi-cyan     15. █ hi-white
  705.  
  706.      ----------------------------------------------------------------------
  707.      Screen aspect ratio:  1         [0.5 to 2.0]
  708.      Save "edit" commands? y  [y,n]
  709.  
  710.      TYPE:  F1 (Help!)  F2 (Entry complete. Proceed)  F3 (Return to previous menu)
  711.               -------------------------------------------------------
  712.  
  713. The fields are as follows:
  714.  
  715.  1. Graphics resolution. hi gives  a  resolution  of  640  dots  horizontally,
  716.     whereas  lo  gives  only  320 dots. Both high and low give 200 dots verti-
  717.     cally. Although high resolution gives a cleaner picture, it will only draw
  718.     in black and white.
  719.  
  720.  2. Palette and background color. If you choose low  resolution,  your  graphs
  721.     will  be  drawn in up to four colors: one background color and up to three
  722.  
  723.  
  724. ______________________________________________________________________________
  725. (c) 1985 by David J. Stang                                   Please Reproduce!
  726.  
  727.  
  728.  
  729.  
  730.  
  731. User Manual for The Draftsman   Page 7
  732. ______________________________________________________________________________
  733.  
  734.  
  735.  
  736.     foreground colors. The foreground colors must be chosen from  one  of  two
  737.     sets,  or palettes. Palette 1 consists of green, red, and brown; palette 2
  738.     is cyan, magenta, and white. The background color can be chosen  from  one
  739.     of eight.
  740.  
  741.  3. Menu  display. These fields allow you to modify the colors used to display
  742.     menus.
  743.  
  744.  4. Screen aspect ratio. Since monitors vary in their  height/width  ratio,  a
  745.     circle  which  is round on one screen may not appear round on another. You
  746.     can make your circles round by setting an appropriate  aspect  ratio.  For
  747.     the Amdek Color II, for example, the ratio is .93. Another common ratio is
  748.     .833.
  749.  
  750.  5. Save  edit  commands.  If  you  enter  y, The Draftsman remembers all edit
  751.     commands. You must enter yes if you use the F4 option to  execute  a  com-
  752.     plete  graph  specification,  or  if  you want to use the pen plotter. The
  753.     saved edit commands consume memory, however, and if you need to  create  a
  754.     complex chart, you may need to enter n.
  755.  
  756.  
  757.  
  758.                               5.  Specify Input
  759.  
  760. You  use  this menu to tell The Draftsman where your data are coming from. The
  761. menu resembles the figure shown below:
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790. ______________________________________________________________________________
  791. (c) 1985 by David J. Stang                                   Please Reproduce!
  792.  
  793.  
  794.  
  795.  
  796.  
  797. User Manual for The Draftsman   Page 8
  798. ______________________________________________________________________________
  799.  
  800.  
  801.  
  802.                  ---=== _T_a_b_l_e_ 3_: S_p_e_c_i_f_y_ I_n_p_u_t_ M_e_n_u__ ===---
  803.                              3.  SPECIFY INPUT                           Free: 32620
  804.  
  805.      Here you create (or retrieve) the data which is to be plotted.  Normally,
  806.      type EDIT to enter new data (or make changes to old data).  You can also
  807.      retrieve a saved VISICALC file from disk (type DIF) or a more general data
  808.      file (type DATA).
  809.  
  810.      Source of data: edit             [edit, dif, data]
  811.      File number:    1                [1, 2, or 3]
  812.  
  813.      Number of x values (rows):   12  [1 to 24]
  814.      Number of y values for
  815.         each x value (y-columns): 1   [1 to 5]
  816.      Modify existing file size?   n   [y or n]
  817.  
  818.      For source = dif or data -
  819.         name of file:
  820.  
  821.      Note: x values are typically time periods: months, quarters, or years.
  822.            y values are measures - sales, profits, etc. - associated with
  823.            each of the time periods.
  824.  
  825.  
  826.      TYPE:  F1 (Help!)  F2 (Entry complete. Proceed)  F3 (Return to previous menu)
  827.               -------------------------------------------------------
  828.  
  829. The fields are discussed in the remainder of this section.
  830.  
  831.  
  832. 5.1  S_o_u_r_c_e_ o_f_ D_a_t_a_
  833.  
  834.  
  835.  
  836. 5.1.1  Edit.  This means that you will enter the data directly. If you  select
  837. edit,  The  Draftsman  will display a table (menu 3.1) and let you type in the
  838. values you want to plot. This will probably be your usual choice.  The  figure
  839. below  shows  the  input  screen  you  would  see  if  you  were to accept The
  840. Draftsman's defaults, and choose to enter 12 values of x, 12  values  of  1  y
  841. variable.
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856. ______________________________________________________________________________
  857. (c) 1985 by David J. Stang                                   Please Reproduce!
  858.  
  859.  
  860.  
  861.  
  862.  
  863. User Manual for The Draftsman   Page 9
  864. ______________________________________________________________________________
  865.  
  866.  
  867.  
  868.                    ---=== _T_a_b_l_e_ 4_: D_a_t_a_ E_n_t_r_y_ M_e_n_u__ ===---
  869.                              3.1  EDIT:  FILE  1                          Free: 32356
  870.  
  871.       ROW        X           Y1          Y2          Y3          Y4          Y5
  872.  
  873.         1                 0
  874.         2                 0
  875.         3                 0
  876.         4                 0
  877.         5                 0
  878.         6                 0
  879.         7                 0
  880.         8                 0
  881.         9                 0
  882.        10                 0
  883.        11                 0
  884.        12                 0
  885.  
  886.      TYPE:  cursor left/right to move within a field
  887.             cursor up/down    to move vertically between fields
  888.             F9/F10            to move horizontally between fields
  889.             F7/F8             to move data page up/down
  890.  
  891.  
  892.      TYPE:  F1 (Help!)  F2 (Entry complete. Proceed)  F3 (Return to previous menu)
  893.               -------------------------------------------------------
  894.  
  895.  
  896.  
  897. 5.1.2  DIF.  This indicates that you want to retrieve a file previously stored
  898. on disk in the Lotus/Software Arts DIF format. Two points:
  899.  
  900.  1. If you are using VisiCalc, the file must have been saved in column format,
  901.     i.e., you must have pressed C in response to the VisiCalc prompt: R, C, or
  902.     enter
  903.  
  904.  2. the file must contain no column labels.
  905.  
  906. The Draftsman is somewhat intractable in the file format it expects. The first
  907. column  contains  the  x  values  and is considered to be alphabetic. All sub-
  908. sequent columns (up to a maximum of five) must contain strictly numeric  data.
  909. A  section  later in this chapter discusses how to bring your 1-2-3 worksheets
  910. into The Draftsman.
  911.  
  912.  
  913. 5.1.3  DATA.  This option also means that you want to fetch a file from  disk.
  914. Here  is  an  example  of a data file with 3 months of data and two values for
  915. each month:
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922. ______________________________________________________________________________
  923. (c) 1985 by David J. Stang                                   Please Reproduce!
  924.  
  925.  
  926.  
  927.  
  928.  
  929. User Manual for The Draftsman   Page 10
  930. ______________________________________________________________________________
  931.  
  932.  
  933.  
  934.          ---=== _T_a_b_l_e_ 5_: S_a_m_p_l_e_ D_a_t_a_ F_i_l_e_ (C_o_m_m_a_ D_e_l_i_m_i_t_e_d_)_ ===---
  935.      3,2
  936.      Jan,50,10
  937.      Feb,30,20
  938.      Mar,60,30
  939.               -------------------------------------------------------
  940.  
  941. The data format is as follows:
  942.  
  943.  1. The first line (record) in the file gives the number of rows of  data  and
  944.     the number of y values (numeric columns).
  945.  
  946.  2. subsequent lines in the file correspond to a single row of data (i.e., one
  947.     x value and all y values for that x)
  948.  
  949.  3. adjacent values in each line are separated by commas and/or spaces.
  950.  
  951.  4. If  an  x  value  contains  any special characters or spaces, it should be
  952.     enclosed in double quotes.
  953.  
  954. A DATA file would normally be created by a text editor, by a BASIC program, or
  955. by The Draftsman. Note that any data entered or modified in menu 3--regardless
  956. of the source--can later be saved to disk using menu 6.
  957.  
  958.  
  959. 5.2  F_i_l_e_ N_u_m_b_e_r_
  960.  
  961. The Draftsman allows you to have three active files in any given session.  You
  962. can  then  plot  the  different  sets by indicating the file number in the 4.n
  963. menus. If you type EDIT and give the number of a  file  which  you  previously
  964. created (either through EDIT or from disk), The Draftsman will enter edit mode
  965. and let you make changes to the file.
  966.  
  967.  
  968. 5.3  N_u_m_b_e_r_ o_f_ x_ V_a_l_u_e_s_, N_u_m_b_e_r_ o_f_ y_ V_a_l_u_e_s_ f_o_r_ E_a_c_h_ x_ V_a_l_u_e_
  969.  
  970. To understand x and y in the context of a graph, its important to have a clear
  971. idea  of  what  you're going to be graphing. In most cases you will be showing
  972. changes in some measure (sales, profits, population) over time (months,  quar-
  973. ters, years).
  974.  
  975. The  x's  are  the  time  periods and correspond to fixed increments along the
  976. horizontal axis of the graph. The x's don't have to be time periods,  but  The
  977. Draftsman  always  considers  x's  to  have character values (with discrete as
  978. opposed to continuous values).
  979.  
  980. The y's, by contrast, are numeric values and correspond to the vertical dimen-
  981. sion of the graph - height of bar for bar charts, height  of  point  for  line
  982. graphs.  The  number  of  x values is simply the number of time periods you're
  983. going to plot, e.g., 12 for 12 months of data.
  984.  
  985. The number of y values will normally be 1, since you will usually be  plotting
  986.  
  987.  
  988. ______________________________________________________________________________
  989. (c) 1985 by David J. Stang                                   Please Reproduce!
  990.  
  991.  
  992.  
  993.  
  994.  
  995. User Manual for The Draftsman   Page 11
  996. ______________________________________________________________________________
  997.  
  998.  
  999.  
  1000. just  one  measure,  e.g.,  sales. You can, however, plot up to five different
  1001. measures on the same graph: both sales and profits, total sales from  each  of
  1002. four  divisions,  monthly  data  from this year and last. When you're entering
  1003. data, each column of data will create one line (line graphs)  or  one  set  of
  1004. bars (bar charts).
  1005.  
  1006. Note  I haven't said anything about pie charts - they're different. Only one y
  1007. is ever used for a pie chart. The y value corresponds to the size of a  slice;
  1008. the x value is the label for the slice.
  1009.  
  1010.  
  1011. 5.4  M_o_d_i_f_y_ E_x_i_s_t_i_n_g_ F_i_l_e_ S_i_z_e_?
  1012.  
  1013. Normally,  the  two  preceeding fields (number of rows, number of columns) are
  1014. ignored unless a new file is created using EDIT. However, if you  enter  y  in
  1015. the  modify  field, The Draftsman will use the row and column values to change
  1016. the size of the file.
  1017.  
  1018.  
  1019. 5.5  N_a_m_e_ o_f_ F_i_l_e_
  1020.  
  1021. If you are retrieving a data file from disk, you give the  file  name  in  the
  1022. last  field  in this menu. This name can have one to three parts, e.g., month,
  1023. month.dat, or b:month.dat (the drive: designation is necessary if the file  is
  1024. not on the current default drive).
  1025.  
  1026.  
  1027. 5.6  E_d_i_t_:F_i_l_e_n_
  1028.  
  1029. You  use  this menu to enter or modify data which The Draftsman will plot. The
  1030. process of entering values works much the same as  for  any  other  menu.  You
  1031. should note the following:
  1032.  
  1033.  1. Recall that the x values have character values and all y's are numeric.
  1034.  
  1035.  2. Cursor up and down (or enter) move you vertically.
  1036.  
  1037.  3. F9 and F10 move you horizontally.
  1038.  
  1039.  4. The  editor  will only display 12 rows of data at a time. If you have more
  1040.     than 12 rows in your file, you can move the  display  up  and  down  using
  1041.     function keys F7 and F8.
  1042.  
  1043.  5. Once  you  have finished editing the data, press F2 and you will return to
  1044.     the main menu.
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054. ______________________________________________________________________________
  1055. (c) 1985 by David J. Stang                                   Please Reproduce!
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061. User Manual for The Draftsman   Page 12
  1062. ______________________________________________________________________________
  1063.  
  1064.  
  1065.  
  1066. 5.7  G_r_a_p_h_i_n_g_ V_a_l_u_e_s_ f_r_o_m_ 1_-2_-3_
  1067.  
  1068. To bring your 1-2-3 worksheet into The Draftsman, you may want to follow these
  1069. steps.
  1070.  
  1071.  1. Create the 1-2-3 worksheet. Create one  column  for  your  x  labels,  and
  1072.     adjacent  columns to the immediate right of this column for each of your y
  1073.     variables. Save it with /fs
  1074.  
  1075.  2. Extract from the worksheet only those cells that you wish to  graph.  Even
  1076.     if  you have only entered numbers in the worksheet, if you have erased any
  1077.     cells, your active workspace will include them, so you will need to use  a
  1078.     file  extract: /FX Your extraction should be values, rather than formulas.
  1079.     The upper left corner of the extract range should be your first  x  label,
  1080.     the lower right corner your last y value.
  1081.  
  1082.  3. Exit 1-2-3: /QY.
  1083.  
  1084.  4. If  necessary, insert your 1-2-3 disk containing the Translate program. At
  1085.     the prompt, type TRANSLATE Select WKS to  DIF  from  the  Translate  menu.
  1086.     Select the file you have just saved.
  1087.  
  1088.  5. After  conversion to DIF, exit Translate, and copy your new .DIF file to a
  1089.     The Draftsman data disk (or to your Drawman hard disk directory)
  1090.  
  1091.  6. Load The Draftsman.
  1092.  
  1093.  7. Select Specify Input (Main menu option 3)
  1094.  
  1095.  8. Enter DIF for source of data, and enter the exact DIF  file  name  at  the
  1096.     bottom  of  this  menu.  For  instance, if your file name is deleteme.dif,
  1097.     enter deleteme.dif. You will not need to specify number  of  x  values  or
  1098.     number of y values or any other menu options.
  1099.  
  1100.  9. Move  on  to  Main Menu Option 4. If you have moved too many values in for
  1101.     medium resolution mode, you can go to the Main  Menu,  and  redefine  your
  1102.     graphics resolution to be hi.
  1103.  
  1104.  
  1105.  
  1106.                        6.  General Plot Specifications
  1107.  
  1108. You  use  this  menu to tell The Draftsman about the pieces which are going to
  1109. make up your plot. The figure below depicts this menu.
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120. ______________________________________________________________________________
  1121. (c) 1985 by David J. Stang                                   Please Reproduce!
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127. User Manual for The Draftsman   Page 13
  1128. ______________________________________________________________________________
  1129.  
  1130.  
  1131.  
  1132.           ---=== _T_a_b_l_e_ 6_: G_e_n_e_r_a_l_ P_l_o_t_ S_p_e_c_i_f_i_c_a_t_i_o_n_s_ M_e_n_u__ ===---
  1133.                       4.  GENERAL PLOT SPECIFICATIONS                    Free: 32470
  1134.  
  1135.      In this menu, you choose the type of chart you want to make.
  1136.  
  1137.      If you want to use a specification file which you saved earlier, enter
  1138.      the file name here:                  and then type F2 to proceed.
  1139.  
  1140.      Otherwise, using one or more lines below, select from:
  1141.  
  1142.                       pie, bar, line, edit, or erase
  1143.  
  1144.      After each selection, type F2 (or F4; refer to help for difference)
  1145.      and THE DRAFTSMAN will take you to another menu where you can give more
  1146.      information about the plot.
  1147.  
  1148.                           1.                     2.
  1149.                           3.                     4.
  1150.                           5.                     6.
  1151.                           7.                     8.
  1152.                           9.                    10.
  1153.  
  1154.  
  1155.  
  1156.      TYPE:  F1 (Help!)  F2 (Entry complete. Proceed)  F3 (Return to previous menu)
  1157.               -------------------------------------------------------
  1158.  
  1159. Since most plots have only one piece, this step is simple. For  example,  sup-
  1160. pose  you  want  to plot a bar chart. Then type BAR (or bar) on line 1 and hit
  1161. F2. The Draftsman will take you to another menu and ask for some more  details
  1162. about  your bar chart - Do you want a title? What colors do you want to use? -
  1163. and so forth. Then the plot will be drawn and your task will be accomplished.
  1164.  
  1165. As you gain more experience with The Draftsman, however,  you  might  like  to
  1166. embellish  your graph beyond what BAR will do. You can add your organization's
  1167. logo to the plot, a legend for the graph, or a note with an arrow to highlight
  1168. a particular aspect of the data. The Draftsman will also  allow  you  to  plot
  1169. multiple  charts on a single page. To construct complex charts, you build your
  1170. plot a step at a time by entering one of the five  basic  graph  components  -
  1171. pie, bar, line, text, or edit - on successive lines of this menu.
  1172.  
  1173. A few points:
  1174.  
  1175.  1. Normally, after entering a choice (pie, bar, etc.), you press either F2 or
  1176.     F4.  If  you  press F2:; The Draftsman will then take you to an associated
  1177.     menu (e.g., 4.1 for pie charts) and ask for more  information.  After  you
  1178.     have  completed  that  menu  and  that part of the plot is drawn, you will
  1179.     return to menu 4 on the next line.
  1180.  
  1181.     If you press F4, The Draftsman will  automatically  execute  all  graphics
  1182.     commands  you have entered, from the current line down. This allows you to
  1183.     redraw a set of graph specifications without repeatedly pressing F2.
  1184.  
  1185.  
  1186. ______________________________________________________________________________
  1187. (c) 1985 by David J. Stang                                   Please Reproduce!
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193. User Manual for The Draftsman   Page 14
  1194. ______________________________________________________________________________
  1195.  
  1196.  
  1197.  
  1198.     When you are finished plotting, press Ctrl-Break or F3 to  return  to  the
  1199.     main menu.
  1200.  
  1201.     If  you  press cursor up: The Draftsman will move the cursor to line 1 and
  1202.     the current chart (but none of the specifications)  will  be  erased.  You
  1203.     will  find yourself doing this frequently to fiddle with a chart--changing
  1204.     the title, position, etc.--until you are satisfied.
  1205.  
  1206.  2. If you enter erase, all current  graph  specifications,  as  well  as  the
  1207.     current graph, are erased.
  1208.  
  1209.  3. Using  menu 6, you can save the complete set of specifications for a chart
  1210.     that you entered in  menu  4  and  the  sub-menus  4.1,  4.2,  etc.  These
  1211.     specifications  can  then  be  retrieved (enter the file name in the first
  1212.     field of this menu) and used to plot a new set of data.
  1213.  
  1214.  
  1215.                            7.  Pie Chart Specifications
  1216.  
  1217.     In this menu, you give The Draftsman some information on how you want your
  1218.     pie chart plotted. This menu is displayed whenever you enter PIE  in  menu
  1219.     4. The figure below shows this menu:
  1220.  
  1221.                      ---=== _T_a_b_l_e_ 7_: P_i_e_ C_h_a_r_t_ M_e_n_u__ ===---
  1222.                                                                              Free: 32262
  1223.                            4.1  PIE CHART SPECIFICATIONS
  1224.  
  1225.          Title:
  1226.          Footnote:
  1227.  
  1228.          Explode [enter x value or leave blank]:
  1229.          Pie colors:
  1230.                      [ 1  2  4  6]
  1231.                        █  █  █  █
  1232.                      (use 100+n for dot shading in color n,
  1233.                           200+n for line shading in color n)
  1234.  
  1235.          Note: In pie charts, "x" designates the label to be attached to a slice,
  1236.                e.g., month, and "y" determines the size of the slice, e.g.,
  1237.                sales.
  1238.          -----------------------------------------------------------------------
  1239.          Data file # [1,2,3]: 1             Y column [1,2,...,5]: 1
  1240.          Chart size [blank or 1-320]:       and position:         [x,y from 0-319]
  1241.             (size and position will normally be left blank or filled with the
  1242.             maximum value: size = 320, position = 0,0)
  1243.  
  1244.  
  1245.          TYPE:  F1 (Help!)  F2 (Entry complete. Proceed)  F3 (Return to previous menu)
  1246.                 -------------------------------------------------------
  1247.  
  1248. Don't  be  too  concerned  about  making mistakes; it's not necessary to enter
  1249. anything in this menu! You can simply press F2 (twice, as you will  see  under
  1250.  
  1251.  
  1252. ______________________________________________________________________________
  1253. (c) 1985 by David J. Stang                                   Please Reproduce!
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259. User Manual for The Draftsman   Page 15
  1260. ______________________________________________________________________________
  1261.  
  1262.  
  1263.  
  1264. the  discussion  of  chart  size below) and a pie will be drawn. You can later
  1265. return to this menu (press cursor up in menu 4 to return to your PIE line), to
  1266. make changes to the plot.
  1267.  
  1268.  
  1269.  
  1270. 7.1  T_i_t_l_e_ a_n_d_ F_o_o_t_n_o_t_e_ F_i_e_l_d_s_
  1271.  
  1272. These fields should be self-explanatory. If you want more than  one  title  or
  1273. footnote line, use EDIT (starting from menu 4).
  1274.  
  1275.  
  1276. 7.2  E_x_p_l_o_d_e_
  1277.  
  1278. This option allows you to highlight the data for a given month (year, quarter)
  1279. by  separating  the  corresponding pie slice from the rest of the pie. For ex-
  1280. ample, to explode February's piece, type Feb on this line  (providing  the  x-
  1281. value  in  your file is feb or Feb or FEB. Although capitalization is ignored,
  1282. abbreviations can't be recognized.)
  1283.  
  1284.  
  1285. 7.3  P_i_e_ C_o_l_o_r_s_
  1286.  
  1287. Under this field The Draftsman displays the current active  colors,  either  2
  1288. for  high resolution or 4 for low resolution. You can generate different shad-
  1289. ing patterns by adding 100 or 200 to a color. For example,  4  will  paint  in
  1290. solid  red, 104 will shade with red dots, and 204 will shade with red horizon-
  1291. tal lines. You can leave this field blank, in which case  The  Draftsman  will
  1292. choose a standard set of colors.
  1293.  
  1294.  
  1295. 7.4  D_a_t_a_ F_i_l_e_
  1296.  
  1297. This  is  the  number of a file containing the data you want to plot. You will
  1298. have created this file using menu 3. Normally, you will have only  one  active
  1299. file and this number should be one.
  1300.  
  1301.  
  1302. 7.5  Y_ c_o_l_u_m_n_
  1303.  
  1304. In  a  pie chart, you can only plot one y, or one column of data in your file.
  1305. For example, if you plot sales by month, your pie will represent  total  sales
  1306. for  the  months represented; each slice of the pie will correspond to a month
  1307. and the size of the slice will be proportional to the volume of sales for that
  1308. month. If your data file has several columns of y values, enter the number  of
  1309. the column to plot; otherwise, leave this value 1.
  1310.  
  1311.  
  1312. 7.6  C_h_a_r_t_ S_i_z_e_ a_n_d_ P_o_s_i_t_i_o_n_ (b_o_x_i_n_g_)
  1313.  
  1314. You  will  normally leave these fields blank. The Draftsman will then find the
  1315. minimum size required to plot your pie, and will display a square this size on
  1316.  
  1317.  
  1318. ______________________________________________________________________________
  1319. (c) 1985 by David J. Stang                                   Please Reproduce!
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325. User Manual for The Draftsman   Page 16
  1326. ______________________________________________________________________________
  1327.  
  1328.  
  1329.  
  1330. the screen. You can make the square larger by typing B (for Bigger),  or  move
  1331. it  to  another  place  on the screen using the cursor (used mainly if you are
  1332. plotting several charts on the same page). Once you have settled on a size and
  1333. location for your graph, press F2 and  the  pie  chart  will  be  drawn.  This
  1334. process  is  called  boxing  and  is  one  of  the most useful features of The
  1335. Draftsman; it gives you maximum flexibility in the composition of your graph.
  1336.  
  1337. If you enter a specific size and location, The Draftsman will try to plot  the
  1338. pie  chart  in  that size (you will get an error message if it can't be done).
  1339. Size and position are measured in low resolution units (i.e.,  the  screen  is
  1340. 320  wide  by  200  high).  To  make  your  chart  as large as possible, enter
  1341. size=320, position=0,0 (these are the  coordinates  of  the  upper  left  hand
  1342. corner).
  1343.  
  1344. Note  that  if you return to menu 4.1 after the pie chart is drawn, perhaps to
  1345. change the title, the size and location that was used to  draw  the  pie  will
  1346. have  been inserted by The Draftsman. If you want to box your pie, you'll have
  1347. to erase the size field.
  1348.  
  1349.  
  1350.                          8.  Bar Chart Specifications
  1351.  
  1352. You use this menu (see figure below) to provide details on how you  want  your
  1353. bar chart plotted.
  1354.  
  1355.                    ---=== _T_a_b_l_e_ 8_: B_a_r_ C_h_a_r_t_ M_e_n_u__ ===---
  1356.                        4.2  BAR CHART SPECIFICATIONS                     Free: 32172
  1357.  
  1358.      Title:
  1359.      Footnote:
  1360.      X-label:
  1361.      Y-label:                        (one or two lines)
  1362.  
  1363.  
  1364.      Bar format [stack, cluster]:             (if more than one y column)
  1365.      Bar color(s):                            (one color for each y column)
  1366.                    [ 1  2  4  6]
  1367.                      █  █  █  █
  1368.                    (add 100 for dot shading, 200 for line shading)
  1369.      Enclose chart in box [y,n]:  y
  1370.      Horizontal reference value:              (y value, or leave blank)
  1371.      Baseline value:                          (y value, or leave blank)
  1372.      -----------------------------------------------------------------------
  1373.      Data file # [1,2,3]: 1         Y column(s):             [blank, or 1-5]
  1374.      Minimum column width [8-100]: 8
  1375.      Chart size [blank or 1-320]:       and position:         [x,y from 0-319]
  1376.         (size and position will normally be left blank or filled with the
  1377.         maximum value: size = 320, position = 0,0)
  1378.  
  1379.      TYPE:  F1 (Help!)  F2 (Entry complete. Proceed)  F3 (Return to previous menu)
  1380.               -------------------------------------------------------
  1381.  
  1382.  
  1383.  
  1384. ______________________________________________________________________________
  1385. (c) 1985 by David J. Stang                                   Please Reproduce!
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391. User Manual for The Draftsman   Page 17
  1392. ______________________________________________________________________________
  1393.  
  1394.  
  1395.  
  1396. Note  that you don't have to enter anything. The default values assumed by The
  1397. Draftsman are sufficient to plot your data. You can simply  press  F2  if  you
  1398. wish.
  1399.  
  1400.  
  1401. 8.1  T_i_t_l_e_, F_o_o_t_n_o_t_e_
  1402.  
  1403. These  fields  should  be self-explanatory. If you want more than one title or
  1404. footnote line, use EDIT (starting from menu 4).
  1405.  
  1406.  
  1407. 8.2  X_-l_a_b_e_l_
  1408.  
  1409. A description for the x values. For example, if the x values are  months,  the
  1410. x-label might be 1986.
  1411.  
  1412.  
  1413. 8.3  Y_-l_a_b_e_l_
  1414.  
  1415. A  description  for  the y values. Examples: SALES, or TOTAL SALES (using both
  1416. lines).
  1417.  
  1418.  
  1419. 8.4  B_a_r_ C_o_l_o_r_s_
  1420.  
  1421. Under this field The Draftsman displays the current active  colors,  either  2
  1422. for  high resolution or 4 for low resolution. You can generate different shad-
  1423. ing patterns by adding 100 or 200 to a color. For example,  4  will  paint  in
  1424. solid  red, 104 will shade with red dots, and 204 will shade with red horizon-
  1425. tal lines. You can leave this field blank, in which case  The  Draftsman  will
  1426. choose a standard set of colors.
  1427.  
  1428.  
  1429. 8.5  B_a_r_ F_o_r_m_a_t_
  1430.  
  1431. This  only  applies  if you are plotting several y values for each x value. If
  1432. you STACK the values, the y's are accumulated vertically, and a single  column
  1433. is  drawn  for each x. Suppose, for example, that you are plotting total sales
  1434. for four divisions of your organization, by month. The you would have  four  y
  1435. values  for  each  month, and the height of the stacked column would represent
  1436. total sales for the entire company. With CLUSTER, the  y  values  are  plotted
  1437. side by side, so that you have several columns for each x.
  1438.  
  1439.  
  1440. 8.6  E_n_c_l_o_s_e_ C_h_a_r_t_ i_n_ B_o_x_
  1441.  
  1442. If you select no, only a single vertical and horizontal axis are drawn.
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450. ______________________________________________________________________________
  1451. (c) 1985 by David J. Stang                                   Please Reproduce!
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457. User Manual for The Draftsman   Page 18
  1458. ______________________________________________________________________________
  1459.  
  1460.  
  1461.  
  1462. 8.7  H_o_r_i_z_o_n_t_a_l_ R_e_f_e_r_e_n_c_e_ V_a_l_u_e_
  1463.  
  1464. If  you  enter  a value, a horizontal line will be drawn across the chart at a
  1465. height corresponding to that value.
  1466.  
  1467.  
  1468. 8.8  B_a_s_e_l_i_n_e_ V_a_l_u_e_
  1469.  
  1470. If you enter a value, this value will be used as  the  bottom  of  the  graph.
  1471. Normally,  the baseline value is 0, and all bars extend from 0 to the y value.
  1472. Suppose, however, that all your y's have high values in a fairly narrow range,
  1473. e.g., 1000, 1100, 1200, 1150, 1300. In this example, a baseline value of  1000
  1474. will  magnify  the apparent differences between the values. To deemphasize the
  1475. differences, of course, leave the baseline zero.
  1476.  
  1477.  
  1478. 8.9  D_a_t_a_ F_i_l_e_
  1479.  
  1480. This is the number of the file containing the data you want to plot. Files are
  1481. created using menu 3. Refer to page 2.3 of on-line help for  more  information
  1482. about files.
  1483.  
  1484.  
  1485. 8.10  Y_-c_o_l_u_m_n_s_
  1486.  
  1487. If  this  field  is blank, The Draftsman will use all columns in the file, and
  1488. will plot up to five bars for each x value. You can enter a specific  list  of
  1489. columns numbers if you don't want to use the whole file.
  1490.  
  1491.  
  1492. 8.11  M_i_n_i_m_u_m_ C_o_l_u_m_n_ W_i_d_t_h_
  1493.  
  1494. The  Draftsman  tries  to make optimal use of space by making the bars in your
  1495. chart as narrow as possible. Normally, "as narrow as possible" is  not  objec-
  1496. tionably  skinny  because  each column has to accomodate at least the x value.
  1497. However, if your x values are short, or if you want wide  bars,  you  can  in-
  1498. crease this value above 8. Beware, though, because you can very quickly expand
  1499. your graph beyond the limits of the screen.
  1500.  
  1501.  
  1502. 8.12  C_h_a_r_t_ S_i_z_e_ a_n_d_ P_o_s_i_t_i_o_n_
  1503.  
  1504. These two fields have the same meaning as they do for pie charts. Refer to on-
  1505. line  help  pages 2.4.1 and the earlier discussion in this manual for details.
  1506. In particular, you should note the discussion of boxing.
  1507.  
  1508.  
  1509.                         9.  Line Graph Specifications
  1510.  
  1511. In this menu (see figure below), you give The Draftsman information about  the
  1512. line graph you would like plotted.
  1513.  
  1514.  
  1515.  
  1516. ______________________________________________________________________________
  1517. (c) 1985 by David J. Stang                                   Please Reproduce!
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523. User Manual for The Draftsman   Page 19
  1524. ______________________________________________________________________________
  1525.  
  1526.  
  1527.  
  1528.                    ---=== _T_a_b_l_e_ 9_: L_i_n_e_ G_r_a_p_h_ M_e_n_u__ ===---
  1529.                       4.3  LINE GRAPH SPECIFICATIONS                     Free: 32146
  1530.  
  1531.      Title:
  1532.      Footnote:
  1533.      X-label:
  1534.      Y-label:                        (one or two lines)
  1535.  
  1536.  
  1537.      Line color(s):                   (one color for each line)
  1538.                      [ 1  2  4  6]
  1539.                        █  █  █  █
  1540.      Line marker(s): .                [. + s(quare) c(ircle) t(riangle)]
  1541.      Connect points: y                [y(es), n(o)]
  1542.      Enclose chart in box [y,n]: y
  1543.      Horizontal reference value:           (y value, or leave blank)
  1544.      Baseline value:                       (y value, or leave blank)
  1545.      -----------------------------------------------------------------------
  1546.      Data file # [1,2,3]: 1         Y column(s):             [blank, or 1-5]
  1547.      Minimum column width [8-100]: 8
  1548.      Chart size [blank or 1-320]:       and position:         [x,y from 0-319]
  1549.         (size and position will normally be left blank or filled with the
  1550.         maximum value: size = 320, position = 0,0)
  1551.  
  1552.      TYPE:  F1 (Help!)  F2 (Entry complete. Proceed)  F3 (Return to previous menu)
  1553.               -------------------------------------------------------
  1554.  
  1555. Input  to  this menu is very similar to that for bar charts, so I refer you to
  1556. previous pages (or online help page 2.4.2) for help on the following fields:
  1557. title                   footnote                x-label         y-label
  1558. enclose chart           horizontal reference    baseline value  data file #
  1559. y columns               column width            chart size      chart position
  1560. color
  1561. Only the line markers and connect points fields are unique to line graphs.
  1562.  
  1563.  
  1564. 9.1  L_i_n_e_ M_a_r_k_e_r_s_
  1565.  
  1566. Lines connect points; The Draftsman allows these points to be either points, +
  1567. signs, squares, circles, or triangles. The use of these different symbols,  or
  1568. markers,  is  very  useful in distinguishing multiple lines on the same graph.
  1569. For each line that you want to plot, enter the single  letter  or  symbol  for
  1570. that line.
  1571.  
  1572. Like  colors,  if you enter more than one symbol, separate adjacent symbols by
  1573. spaces or commas. If you enter fewer markers than the number of lines you  are
  1574. plotting, The Draftsman will use the first marker for the additional lines.
  1575.  
  1576. To  create a legend which describes what each of the lines represents, use the
  1577. + function in EDIT (starting from menu 4). This  will  draw  the  markers  you
  1578. selected  in  a  column  on  the screen. You can then add text to complete the
  1579. legend.
  1580.  
  1581.  
  1582. ______________________________________________________________________________
  1583. (c) 1985 by David J. Stang                                   Please Reproduce!
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589. User Manual for The Draftsman   Page 20
  1590. ______________________________________________________________________________
  1591.  
  1592.  
  1593.  
  1594. 9.2  C_o_n_n_e_c_t_ P_o_i_n_t_s_
  1595.  
  1596. It is possible to plot points or other markers without connecting them. Simply
  1597. enter no (or n) for each set of y values which you don't  want  connected.  If
  1598. you  enter a single y, all lines will be drawn. With a single n, no lines will
  1599. be drawn.
  1600.  
  1601.  
  1602.                                   10.  Edit
  1603.  
  1604. In edit mode, you add personality to your graph. To start, you may simply want
  1605. to add some text to explain or highlight certain aspects of your chart. As you
  1606. gain experience with EDIT, you will find yourself doing  increasingly  complex
  1607. and  interesting  graphics.  Some  charts, such as flowcharts, can be done en-
  1608. tirely in edit without using PIE, BAR, or LINE. At  first  you  may  find  the
  1609. number  of  choices  overwhelming and the commands complicated. Don't despair.
  1610. For one thing, nothing terrible (usually nothing at all) will  happen  if  you
  1611. make a mistake. At worst, you might paint the whole screen a uniform color. To
  1612. simplify  the  explanation,  I  will  describe the commands in terms of common
  1613. tasks.
  1614.  
  1615. If you intend to use a pen plotter, there are certain restrictions on the  use
  1616. of  edit.  Refer  to  on-line help pages 2.5 and the following for details. To
  1617. begin, here is the Edit command summary.
  1618.  
  1619.                 ---=== _T_a_b_l_e_ 1_0_: E_d_i_t_ C_o_m_m_a_n_d_ S_u_m_m_a_r_y__ ===---
  1620.                                  4.4  EDIT                               Free: 32464
  1621.  
  1622.      With EDIT, you can embellish your graph with arrows, circles, lines,
  1623.      rectangles, and text in virtually unlimited ways.  The commands
  1624.      are summarized below;  additional information is given in help.  When
  1625.      you are ready to begin editing, strike any key.
  1626.  
  1627.      Figures:                               Size adjustment:
  1628.        d        place dot                     B,b      change size
  1629.        l        draw line                     W,w      change width
  1630.        a        draw arrow                    H,h      change height
  1631.        s        draw square                 Movement:
  1632.        c        draw circle                   cursor   up, down, left, right
  1633.      Function keys:                           =        reset step size
  1634.        F1       redisplay this page           >,<      change step size
  1635.        F2       execute saved commands      Special:
  1636.        F3       leave edit                    P        paint (note: capital P)
  1637.        F5       text mode on/off              i,o      get/put screen to disk
  1638.        F6       display/set color             +        symbols for legend
  1639.                                               m        move  (after s)
  1640.                                               E,e      erase (after s)
  1641.                                               f        fix figure (after s,c,m,+)
  1642.  
  1643.      TYPE:  F1 (Help!)  F2 (Entry complete. Proceed)  F3 (Return to previous menu)
  1644.               -------------------------------------------------------
  1645.  
  1646.  
  1647.  
  1648. ______________________________________________________________________________
  1649. (c) 1985 by David J. Stang                                   Please Reproduce!
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655. User Manual for The Draftsman   Page 21
  1656. ______________________________________________________________________________
  1657.  
  1658.  
  1659.  
  1660. 10.1  A_d_d_ T_e_x_t_
  1661.  
  1662. Press F5. This will create a horizontal cursor  and  put  you  in  text  mode.
  1663. Everything  you type now goes on the screen. Cursor up, down, left, and right,
  1664. and enter work as you might expect. Type F5 again to get out of text mode.
  1665.  
  1666.  
  1667. 10.2  G_e_t_ H_e_l_p_
  1668.  
  1669. Press F1, and the summary of instructions provided in menu 4.4  will  be  dis-
  1670. played.  If  you  press F1 again, a more detailed description (similar to what
  1671. you are reading now) will be presented.
  1672.  
  1673.  
  1674. 10.3  L_e_a_v_e_ E_d_i_t_
  1675.  
  1676. Press F3.
  1677.  
  1678.  
  1679. 10.4  P_l_a_c_e_ a_ D_o_t_
  1680.  
  1681. Press d.
  1682.  
  1683.  
  1684. 10.5  D_r_a_w_ a_ L_i_n_e_
  1685.  
  1686. Press l (ell, lower case L, not one). This will draw a line to either: 1)  the
  1687. last dot, or 2) the end of the last line, or 3) the tip of the last arrow.
  1688.  
  1689. If you press l as your very first command in EDIT, nothing will happen because
  1690. there was no previous dot, line, or arrow.
  1691.  
  1692.  
  1693. 10.6  D_r_a_w_ a_n_ A_r_r_o_w_
  1694.  
  1695. Press  a.  This  works  just  like  line. The arrow points towards the current
  1696. cursor position.
  1697.  
  1698.  
  1699. 10.7  M_o_v_e_
  1700.  
  1701. Use the cursor. The basic movement step, both vertically and horizontally,  is
  1702. one  character.  If  you  want  to diminish this step, press <. If you want to
  1703. increase this step, press >. If you want to reset the step to  one  character,
  1704. press =.
  1705.  
  1706.  
  1707. 10.8  F_i_n_d_ O_u_t_ W_h_e_r_e_ Y_o_u_ A_r_e_
  1708.  
  1709. A  serious  reponse  to  this  problem:  the current location of the cursor is
  1710. indicated by a +. Note that this changes to a _ in text mode.
  1711.  
  1712.  
  1713.  
  1714. ______________________________________________________________________________
  1715. (c) 1985 by David J. Stang                                   Please Reproduce!
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721. User Manual for The Draftsman   Page 22
  1722. ______________________________________________________________________________
  1723.  
  1724.  
  1725.  
  1726. 10.9  E_x_e_c_u_t_e_ S_a_v_e_d_ E_d_i_t_ C_o_m_m_a_n_d_s_
  1727.  
  1728. If you reenter edit (by typing cursor up in menu 4), you can redo all of  your
  1729. previous  editing  by typing F2 as the very first key. The Draftsman will then
  1730. step through your previous commands and prepare to continue. If your first key
  1731. is other than F2, The Draftsman assumes that you want to  drop  what  you  did
  1732. before, and it is erased from memory.
  1733.  
  1734.  
  1735. 10.10  W_r_i_t_e_ Y_o_u_r_ N_a_m_e_ i_n_ L_o_n_g_h_a_n_d_
  1736.  
  1737. Press  < a few times to diminish the movement step to one dot. Then press d to
  1738. get started with a dot, followed by (move) l (move) l= (move) l  ...  This  is
  1739. not  as  painful  as  it seems. You can do a letter in a minute or less with a
  1740. little practice.
  1741.  
  1742.  
  1743. 10.11  C_h_a_n_g_e_ C_o_l_o_r_
  1744.  
  1745. Press F6. The current active colors will be displayed at the top of the screen
  1746. and the cursor will disappear. Type the number of the desired color,  and  the
  1747. cursor will reappear in the new color.
  1748.  
  1749.  
  1750. 10.12  D_r_a_w_ a_ R_e_c_t_a_n_g_l_e_
  1751.  
  1752. First press s. This causes a square to appear in the center of the screen. You
  1753. are now in square mode, and your task, before exiting, is to set the position,
  1754. size,  and  shape  of  the square (or rectangle). Use the cursor to change the
  1755. position. The size and shape are affected by six different keys:
  1756.  
  1757.  1. B makes the rectangle bigger (both height and width),
  1758.  
  1759.  2. b makes it smaller,
  1760.  
  1761.  3. W makes it wider,
  1762.  
  1763.  4. w makes it thinner,
  1764.  
  1765.  5. H makes it higher,
  1766.  
  1767.  6. and h makes it shorter.
  1768.  
  1769. When you have the rectangle where you want it, press f to fix the figure. Note
  1770. that the rectangle will not have the current color until it is finished. Note:
  1771. all of the size commands B, b, W,
  1772.  w, H, and h are affected by <, =, and >.
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780. ______________________________________________________________________________
  1781. (c) 1985 by David J. Stang                                   Please Reproduce!
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787. User Manual for The Draftsman   Page 23
  1788. ______________________________________________________________________________
  1789.  
  1790.  
  1791.  
  1792. 10.13  A_d_d_ a_ L_e_g_e_n_d_
  1793.  
  1794. If you've plotted more than one set of bars, or more than one line on the same
  1795. graph, you probably want to add a legend to describe the meaning of  each  bar
  1796. or  line.  You can use the + command to draw a column of symbols corresponding
  1797. to your last bar or line graph. You can then  append  a  description  to  each
  1798. symbol.
  1799.  
  1800. When  you press + The Draftsman draws a rectangle in the center of the screen.
  1801. This rectangle has the same shape and size as the column of symbols.  Use  the
  1802. cursor  to  move the rectangle to the place you want to add the legend (unlike
  1803. s, you can't change the shape or size). When you've settled on a  final  posi-
  1804. tion,  press  f;  the  rectangle will disappear, the column of symbols will be
  1805. drawn, and you will be placed in text mode.
  1806.  
  1807.  
  1808. 10.14  D_r_a_w_ a_ C_i_r_c_l_e_ (o_r_ O_v_a_l_)
  1809.  
  1810. This is very similar to square. First press c. This will draw a circle in  the
  1811. center  of your screen and puts you in circle mode. The circle will respond to
  1812. B, b, W, w, H, h in the same way the square did. Again, finish up with an f.
  1813.  
  1814.  
  1815. 10.15  B_a_c_k_ U_p_ y_o_u_r_ S_c_r_e_e_n_ t_o_ D_i_s_k_
  1816.  
  1817. Press o (for output). The Draftsman will prompt you for a file  name.  If  you
  1818. are doing complex editing, it's a good idea to back up your screen frequently,
  1819. because it is possible to destroy your work. The o function in EDIT duplicates
  1820. one of the options of menu 6 -- to save a screen.
  1821.  
  1822.  
  1823. 10.16  R_e_t_r_i_e_v_e_ a_ S_c_r_e_e_n_ f_r_o_m_ D_i_s_k_
  1824.  
  1825. Press i (for Input). The Draftsman will prompt you for a file name.
  1826.  
  1827.  
  1828. 10.17  P_a_i_n_t_ a_ R_e_g_i_o_n_
  1829.  
  1830. Press  P.  This  paints  the  current region in the color of the cursor, where
  1831. region is determined as follows: beginning at the cursor, The Draftsman  looks
  1832. vertically  down  until it finds a dot which is a different color than the one
  1833. lying under the cursor. This color of this dot defines  the  boundary  of  the
  1834. region.  Example: a red cursor lies in the center of a yellow circle on a blue
  1835. background. The Draftsman looks down from  the  blue  center  until  it  finds
  1836. yellow,  then  paints  the  circle  red.  Beware: if the region doesn't have a
  1837. complete boundary, the whole screen may be painted. This can be frustrating if
  1838. you've just spent four hours creating a PC Mona Lisa. Suggestion:  use  the  o
  1839. command frequently, and, in general, avoid the letter P.
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846. ______________________________________________________________________________
  1847. (c) 1985 by David J. Stang                                   Please Reproduce!
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853. User Manual for The Draftsman   Page 24
  1854. ______________________________________________________________________________
  1855.  
  1856.  
  1857.  
  1858. 10.18  D_r_a_w_ a_ F_l_o_w_c_h_a_r_t_
  1859.  
  1860. Fill  your  screen  with  text first. Then enclose the text with rectangles or
  1861. ovals. Don't forget you can use the < to adjust stepsize to position a  figure
  1862. exactly. Finally, add arrows using the d and a commands.
  1863.  
  1864.  
  1865. 10.19  E_r_a_s_e_ a_ L_i_n_e_
  1866.  
  1867. Place  the  cursor at one end of the line. Type d to put a dot there. Move the
  1868. cursor to the other end of the line. Change the current  color  to  the  back-
  1869. ground. Then press l. The line will disappear.
  1870.  
  1871.  
  1872. 10.20  E_r_a_s_e_ a_ R_e_g_i_o_n_
  1873.  
  1874. Press s. This draws a square in the center of the screen. Use the cursor and s
  1875. and  B, b, etc. to place the square (or rectangle) over the region you want to
  1876. erase. Then press E. The rectangle will disappear, as will the region, and you
  1877. will be out of square mode. If you type a lower case e, the rectangle will  be
  1878. painted in the current color.
  1879.  
  1880.  
  1881. 10.21  M_o_v_e_ a_ S_e_c_t_i_o_n_ o_f_ t_h_e_ P_l_o_t_ t_o_ a_ D_i_f_f_e_r_e_n_t_ L_o_c_a_t_i_o_n_
  1882.  
  1883. Even  with the flexibility afforded by boxing (if you don't know what this is,
  1884. read the discussion of chart size in online help page 2.4.1, or elsewhere here
  1885. is this manual), you sometimes want to adjust a graph after  it  is  drawn  by
  1886. moving pieces around. This is accomplished with the s ... m ... f sequence, as
  1887. follows:
  1888.  
  1889. First  press  s.  Use  the cursor and B, b, etc. until the section to be moved
  1890. (which I'll call the stbm) is enclosed. Then press m. This puts  you  in  move
  1891. mode, and the only keys which are active are the cursor, and <, =, and >. When
  1892. you press the cursor keys, two rectangles will appear on the screen: the first
  1893. rectangle will remain fixed around the stbm, and the second--in the same shape
  1894. and size--will be drawn where the cursor dictates. The second rectangle repre-
  1895. sents the new location for the stbm. When you press f--to finish the move--the
  1896. stbm will be moved and both rectangles will disappear.
  1897.  
  1898.  
  1899.                         11.  Produce Hard Copy Output
  1900.  
  1901. This  menu allows you to make a permanent copy of your graph on an Epson MX-80
  1902. printer or an HP-7470 pen plotter. A look at  this  menu  is  offered  by  the
  1903. figure below:
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912. ______________________________________________________________________________
  1913. (c) 1985 by David J. Stang                                   Please Reproduce!
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919. User Manual for The Draftsman   Page 25
  1920. ______________________________________________________________________________
  1921.  
  1922.  
  1923.  
  1924.                 ---=== _T_a_b_l_e_ 1_1_: P_r_i_n_t_e_r_/P_l_o_t_t_e_r_ M_e_n_u__ ===---
  1925.                        5.  PRODUCE HARD COPY OUTPUT                      Free: 32401
  1926.  
  1927.      Device: epson  [HP, EPSON]  (HP-7470 pen plotter or Epson MX-80 printer)
  1928.  
  1929.      If EPSON: printer aspect ratio: 1         [0.5 to 2.0]
  1930.                   (horizontal dots per inch / vertical dots per inch)
  1931.                orientation: v  [h(orizontal) or v(ertical)]
  1932.  
  1933.      If HP:    Match screen colors to pen colors by entering 1 or 2 letter pen
  1934.                codes (e.g., r, g, bl, bk) in the fields below.  An * marks
  1935.      each color used in the current graph, so only these fields need be entered.
  1936.      THE DRAFTSMAN will later prompt you to insert pens using these codes.
  1937.  
  1938.      There are some differences between screen graphics and plotter graphics.
  1939.      Refer to help for an explanation.
  1940.  
  1941.          0.    black       4.    red         8.    hi-black   12.    hi-red
  1942.          1.    blue        5.    magenta     9.    hi-blue    13.    hi-magenta
  1943.          2.    green       6.    yellow     10.    hi-green   14.    hi-yellow
  1944.          3.    cyan        7.    white      11.    hi-cyan    15.    hi-white
  1945.  
  1946.          pen to be used for text:
  1947.  
  1948.      TYPE:  F1 (Help!)  F2 (Entry complete. Proceed)  F3 (Return to previous menu)
  1949.               -------------------------------------------------------
  1950.  
  1951.  
  1952.  
  1953. 11.1  E_p_s_o_n_
  1954.  
  1955.  
  1956.  
  1957. 11.1.1  Print Aspect Ratio.  This is a number which makes circles appear round
  1958. rather than oval. For the EPSON, this value should be .83333 (60 dots per inch
  1959. horizontally  /  72  dots per inch vertically = 5/6). While it is important to
  1960. set this value if you are drawing pie charts, I would leave it at  1.0  other-
  1961. wise, since it gives a little sharper picture.
  1962.  
  1963.  
  1964. 11.1.2  Orientation.  If  you  specify h=horizontal, the graph is printed such
  1965. that the left side of the printer page corresponds to the  left  side  of  the
  1966. screen.  While  this  is  natural in the sense that the graph is printed right
  1967. side up, the width of the page forces  the  printed  graph  to  be  relatively
  1968. small.  The  default  orientation,  therefore,  is v=vertical. With a vertical
  1969. orientation, the left side of the  page  corresponds  to  the  bottom  of  the
  1970. screen.
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978. ______________________________________________________________________________
  1979. (c) 1985 by David J. Stang                                   Please Reproduce!
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985. User Manual for The Draftsman   Page 26
  1986. ______________________________________________________________________________
  1987.  
  1988.  
  1989.  
  1990. 11.2  H_P_-7_4_7_0_
  1991.  
  1992. The  discussion below describes the input fields and operation of the plotter.
  1993. If you have not used the plotter before, read this section carefully.
  1994.  
  1995.  
  1996. 11.2.1  Input.  The color fields allow you to match the colors of your pens to
  1997. the colors which were used to draw the graph on the screen. The match does not
  1998. have to be perfect; (it usually can't be). For example, the screen draws text;
  1999. as white on a black background. Since the paper is white, a black  pen  is  an
  2000. appropriate  match for white. The codes you use to identify the pens are up to
  2001. you; The Draftsman simply uses these codes to tell you what pens he needs.
  2002.  
  2003. Enter as many different colors as you have and would like to use. Even  though
  2004. the  HP  only  holds two pens at a time, a graph can be drawn in more than two
  2005. colors; The Draftsman will prompt you for the pens, two at a time.
  2006.  
  2007. After entering all colors, press F2. The Draftsman first redraws  the  current
  2008. graph on the screen and saves plotter commands in a disk file. After the graph
  2009. is  complete  you  will be instructed to insert a piece of paper, turn on the*
  2010. plotter, and insert the appropriate pens. You can press F3 at any time to stop
  2011. the plot. Note that this; may leave the pen in the middle of the paper; if so,
  2012. lift the paper hold lever to move the pen back to its stall.
  2013.  
  2014.  
  2015. 11.2.2  Retrieving Saved Plots.  If you have saved a screen image to disk  (in
  2016. screen  format  using menu 6, or using the o option of edit), the image cannot
  2017. be retrieved and plotted. Why? Because a saved screen image is a collection of
  2018. dots representing the points on your screen. But when The Draftsman drives the
  2019. plotter, he thinks in terms of lines. It is possible to save a plot for  rapid
  2020. redrawing, but you must do so as follows: First, save the associated data file
  2021. using  menu  6.  Then  save the graph specifications as a spec file, also with
  2022. menu 6. Then to redraw the plot, proceed as follows:
  2023.  
  2024.  1. go to menu 3 and retrieve the data file.
  2025.  
  2026.  2. go to menu 4 and enter the spec file name in the first field.
  2027.  
  2028.  3. Press F2. This will fill menu 4 with the specifications and  position  the
  2029.     cursor one field down.
  2030.  
  2031.  4. Press F4. This will plot the graph.
  2032.  
  2033.  5. now go to menu 5 and create the plot on the HP.
  2034.  
  2035.  
  2036.  
  2037. 11.2.3  Switch Settings.  The switches in the right rear of the plotter should
  2038. be set as follows:
  2039.                             0  0  0 1  1  0  0  0
  2040.                             S2 S1 Y US B4 B3 B2 B1
  2041. Refer  to  online help chapter 4 or to the Installation chapter of this manual
  2042.  
  2043.  
  2044. ______________________________________________________________________________
  2045. (c) 1985 by David J. Stang                                   Please Reproduce!
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051. User Manual for The Draftsman   Page 27
  2052. ______________________________________________________________________________
  2053.  
  2054.  
  2055.  
  2056. if you are curious why.
  2057.  
  2058.  
  2059. 11.2.4  Startup.  When you turn the HP on, it should reach over and  grab  the
  2060. pen  (if  any)  in  the  left  stall. If this doesn't happen, check your power
  2061. supply. 5. Hangup If your plotter fails to  do  anything  when  you  think  it
  2062. should, press F3 to terminate the plot, check power and cable connections, and
  2063. start again. If it continues to fail, contact your dealer.
  2064.  
  2065. If  your  plotter is working properly, the sequence of operations should be as
  2066. follows:
  2067.  
  2068.  1. You complete entry into menu 5 by pressing F2. The Draftsman  redraws  the
  2069.     current graph.
  2070.  
  2071.  2. You  are prompted to turn on the plotter and strike any key when ready. Up
  2072.     to this point the plotter will be silently biding its time, doing nothing.
  2073.  
  2074.  3. You are prompted to insert one or  two  pens  and  "strike  any  key  when
  2075.     ready". At this point the plotter should pick up one of the pens and start
  2076.     to plot.
  2077.  
  2078.  
  2079.  
  2080. 11.2.5  Restrictions  and  Special  Features  of  Edit.  One of the basic dif-
  2081. ferences between screen graphics and plotter graphics is this: If  two  images
  2082. overlap  on  the screen, the second simply erases part of the first. On paper,
  2083. however, ink is not so easily removed, and  generation  of  the  second  image
  2084. produces  ink  on  ink, which may not be desirable. Since The Draftsman allows
  2085. you to overwrite screen  images  in  edit  mode  (menu  4.4),  it  provides  a
  2086. mechanism for erasing ink, as follows:
  2087.  
  2088.  1. If text overlays text, all but the top layer is ignored.
  2089.  
  2090.  2. If  a rectangle is erased using the E or e functions, anything lying under
  2091.     the rectangle will not be plotted. For text, if even a part of a letter is
  2092.     under the rectangle, the entire letter is ignored.
  2093.  
  2094.  3. You can use up to 50 E's in a single graph. (More than this will not cause
  2095.     an error, but are ignored.)
  2096.  
  2097. Two other features of edit are not duplicated on  the  plotter  owing  to  the
  2098. complexity of the functions:
  2099.  
  2100.  1. Move  is  not  recognized  on  the  plotter.  You can move an image on the
  2101.     screen, but when the plot is created, the image remains  in  its  original
  2102.     position.)
  2103.  
  2104.  2. Paint is also ignored on the plotter.
  2105.  
  2106.  
  2107.     11.2.6  Other  Differences  Between Screen and Plotter Graphics.  When The
  2108.  
  2109.  
  2110. ______________________________________________________________________________
  2111. (c) 1985 by David J. Stang                                   Please Reproduce!
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117. User Manual for The Draftsman   Page 28
  2118. ______________________________________________________________________________
  2119.  
  2120.  
  2121.  
  2122.     Draftsman prepares to create a graph on the HP,  it  converts  the  aspect
  2123.     ratio  to  1.0, since one x unit on the plotter is equal to one y unit. If
  2124.     you have previously modified the aspect ratio in menu 2, you may find that
  2125.     text overlays your pie chart. If you plan to produce a plot on the HP, you
  2126.     should therefore either:
  2127.  
  2128.      1. leave the screen aspect ratio at 1.0.  (Although  your  pies  may  not
  2129.         appear round on the screen, they will be round on the HP); or
  2130.  
  2131.      2. If  you  use edit to modify a pie chart, keep all modifications safely
  2132.         away from the pie. A little experimentation will  show  you  how  much
  2133.         "safely" is.
  2134.  
  2135.  
  2136.  
  2137.                             12.  Save Screen/Data/Spec
  2138.  
  2139.     This  menu  allows  you to save your work to disk for later retrieval. The
  2140.     menu is reproduced in the figure below:
  2141.  
  2142.                ---=== _T_a_b_l_e_ 1_2_: S_a_v_e_ S_c_r_e_e_n_/D_a_t_a_/S_p_e_c_ M_e_n_u__ ===---
  2143.                              6.  SAVE SCREEN/DATA/SPEC                       Free: 32358
  2144.  
  2145.          This menu allows you to save information to a disk file. This
  2146.          can consist of a screen image, a data file, or a graph specification
  2147.          (as entered in the 4. menus).
  2148.  
  2149.          Type [screen, data, spec]: screen
  2150.          Diskette file name [e.g., screen1.dat]:
  2151.  
  2152.          If data, file number [1 to 3]: 1    and format [dif, data]: data
  2153.  
  2154.  
  2155.          {some blank lines have been removed from this figure}
  2156.  
  2157.          TYPE:  F1 (Help!)  F2 (Entry complete. Proceed)  F3 (Return to previous menu)
  2158.                 -------------------------------------------------------
  2159.  
  2160. The fields are explained as follows:
  2161.  
  2162.  
  2163. 12.1  S_c_r_e_e_n_
  2164.  
  2165. This is the current graph that you have drawn. Once saved, you  can  fetch  it
  2166. later either to change it (in edit mode, menu 4.4) or to display it as part of
  2167. a slide show (menu 7).
  2168.  
  2169.  
  2170. 12.2  D_a_t_a_
  2171.  
  2172. If  you  keyed  in a data file, you may want to save it so that you can either
  2173. plot it again, or analyze it using another program such as 1-2-3.
  2174.  
  2175.  
  2176. ______________________________________________________________________________
  2177. (c) 1985 by David J. Stang                                   Please Reproduce!
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183. User Manual for The Draftsman   Page 29
  2184. ______________________________________________________________________________
  2185.  
  2186.  
  2187.  
  2188. 12.3  S_p_e_c_
  2189.  
  2190. This is is all the information which has be entered as part of menu  4  (note,
  2191. however,  that  the  commands entered in edit mode are not saved). You can use
  2192. these specifications to plot new data later; they can be retrieved in menu  4.
  2193. See on-line help page 2.4 (or elsewhere in this manual) for more information.
  2194.  
  2195.  
  2196. 12.4  D_i_s_k_e_t_t_e_ F_i_l_e_ N_a_m_e_
  2197.  
  2198. This  is  the  name of the file to be saved. You can either enter a short name
  2199. with  8  characters  or  less  (e.g.,  screen1),  a  qualified   name   (e.g.,
  2200. screen1.dat),  or  a name with a disk drive designation (e.g., b:screen1.dat).
  2201. You must use the last form if you want to save the  file  on  other  than  the
  2202. default drive.
  2203.  
  2204.  
  2205. 12.5  F_i_l_e_ N_u_m_b_e_r_ a_n_d_ F_o_r_m_a_t_
  2206.  
  2207. The  file  number  is  the number that was assigned in menu 3 (refer to online
  2208. help page 2.3 for more information on this). The file can be saved  in  either
  2209. DATA  format  or DIF format. There are reasons for using both formats. In DATA
  2210. format, your file takes up less space on disk and can be read (using  the  DOS
  2211. TYPE  command). In DIF format, however, your file can be used as input to many
  2212. spreadsheets and other programs which accept the data interchange format. Note
  2213. that The Draftsman will always save a DIF file in column format.
  2214.  
  2215.  
  2216.                            13.  Display Slide Show
  2217.  
  2218. This menu allows you to display information at a presentation or as part of  a
  2219. sales demonstration. It is reproduced in the figure below:
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242. ______________________________________________________________________________
  2243. (c) 1985 by David J. Stang                                   Please Reproduce!
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249. User Manual for The Draftsman   Page 30
  2250. ______________________________________________________________________________
  2251.  
  2252.  
  2253.  
  2254.                   ---=== _T_a_b_l_e_ 1_3_: S_l_i_d_e_ S_h_o_w_ M_e_n_u__ ===---
  2255.                           7.  DISPLAY SLIDE SHOW                         Free: 32052
  2256.  
  2257.      This menu allows you to produce a slide show, presenting up to 20 screen
  2258.      images in a rotating sequence.  Your screens must have been previously
  2259.      created and saved as separate files using menu 6.  Indicate the file names
  2260.      using either option 1 or option 2 below.
  2261.  
  2262.      Number of seconds to display each image: 10   [0 to 999]
  2263.         (If you enter 0 seconds, you can manually control the slide
  2264.          presentation.  Refer to help for instructions.)
  2265.  
  2266.      Option 1.  Enter the starting screen number:   , the ending screen:   ,
  2267.                 and the disk drive:    [a to f].  In this option, the screens
  2268.                 must have been saved with names screen1.dat, screen2.dat, etc.
  2269.  
  2270.      Option 2.  Enter the names of the disk files below.
  2271.  
  2272.       1.                 2.                 3.                 4.
  2273.       5.                 6.                 7.                 8.
  2274.       9.                10.                11.                12.
  2275.      13.                14.                15.                16.
  2276.      17.                18.                19.                20.
  2277.  
  2278.      TYPE:  F1 (Help!)  F2 (Entry complete. Proceed)  F3 (Return to previous menu)
  2279.               -------------------------------------------------------
  2280.  
  2281.  
  2282.  
  2283. 13.1  T_i_m_e_
  2284.  
  2285. If  you enter a non-zero value for the time, the slides will be presented in a
  2286. rotating sequence, with each slide  displayed  for  the  length  of  time  you
  2287. specified.  You  end the slide show by typing any key. If you enter 0 seconds,
  2288. you manually control the slide show as follows:
  2289.  
  2290.  1. space bar advances to the next slide. This is the fastest move, since  The
  2291.     Draftsman  is  always reading the next slide into memory while the current
  2292.     slide is being displayed.
  2293.  
  2294.  2. - backs up one slide.
  2295.  
  2296.  3. 1,2,... 0 goes directly to slides 1,2, ... 10
  2297.  
  2298.  4. Alt 1, ...Alt 0 goes directly to slides 11, ... 20
  2299.  
  2300.  5. any other key exits the slide show.
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308. ______________________________________________________________________________
  2309. (c) 1985 by David J. Stang                                   Please Reproduce!
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315. User Manual for The Draftsman   Page 31
  2316. ______________________________________________________________________________
  2317.  
  2318.  
  2319.  
  2320. 13.2  S_l_i_d_e_ N_a_m_e_s_
  2321.  
  2322. If you have saved your slides with names screen1.dat, screen2.dat,  etc.,  you
  2323. can  indicate the names of your slides using option 1. For example, to present
  2324. the slides screen23.dat through screen45.dat on drive A, enter 23, 45,  and  a
  2325. in the option 1 fields.
  2326.  
  2327.  
  2328. 13.3  L_i_s_t_ F_i_l_e_ D_i_r_e_c_t_o_r_y_
  2329.  
  2330. This  menu  (see figure below) is used to list the contents of a disk (or dis-
  2331. kette) on a specified drive. It is most often used when you get  a  "file  not
  2332. found"  error. The sole input field is disk drive, which will normally be A or
  2333. B. Use F3 to exit the menu.
  2334.  
  2335.               ---=== _T_a_b_l_e_ 1_4_: L_i_s_t_ F_i_l_e_ D_i_r_e_c_t_o_r_y_ M_e_n_u__ ===---
  2336.                           8.  LIST FILE DIRECTORY                        Free: 32041
  2337.  
  2338.      Use this menu to determine the files saved on disk.  Enter the letter
  2339.      corresponding to the disk drive: a  [a to f]
  2340.  
  2341.  
  2342.      {some blank lines have been removed from this figure}
  2343.  
  2344.      TYPE:  F1 (Help!)  F2 (Entry complete. Proceed)  F3 (Return to previous menu)
  2345.               -------------------------------------------------------
  2346.  
  2347.  
  2348.  
  2349.                              14.  Error Messages
  2350.  
  2351. This chapter lists all error messages generated by The Draftsman, and provides
  2352. information on how to correct each error. Error messages appear on the  bottom
  2353. line  of  your  screen.  If you press F1 when an error message is present, you
  2354. will enter help at the appropriate page of this chapter.
  2355.  
  2356. 1_0_0_1_ A_n_ u_n_r_e_c_o_v_e_r_a_b_l_e_ e_r_r_o_r_ h_a_s_ o_c_c_u_r_r_e_d_. C_o_n_t_a_c_t_ y_o_u_r_  d_e_a_l_e_r_..  If  you  get
  2357. this  message,  try  to recreate the problem and record the sequence of events
  2358. which led up to the error.
  2359.  
  2360. 1_0_0_2_ T_h_e_ e_n_t_r_y_(s_) h_a_v_e_ t_o_ b_e_ n_u_m_b_e_r_s_ (w_i_t_h_o_u_t_ c_o_m_m_a_s_ o_r_ $ s_i_g_n_s_)..  This means
  2361. that The Draftsman is expecting a number in the menu field. Good numbers: +23,
  2362. -10, 50,4 23.2, .000005, -14E23 (i.e., -14 times 10 to the  23rd  power).  Bad
  2363. numbers:  xxx,  1,000, $5.00. If you think the field shouldn't have a number,2
  2364. go to the help for the explanation of the menu (menu n is  described  on  page
  2365. 2.n).
  2366.  
  2367. 1_0_0_3_  T_h_e_  e_n_t_r_y_  i_s_  n_o_t_ s_p_e_l_l_e_d_ c_o_r_r_e_c_t_l_y_..  Check the list of choices. This
  2368. error will appear when you have to enter a choice from  a  specified  list  of
  2369. values. The Draftsman ignores differences due to capitalization, and sometimes
  2370. allows abbreviations, but usually wants the choice to be entered exactly.
  2371.  
  2372.  
  2373.  
  2374. ______________________________________________________________________________
  2375. (c) 1985 by David J. Stang                                   Please Reproduce!
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381. User Manual for The Draftsman   Page 32
  2382. ______________________________________________________________________________
  2383.  
  2384.  
  2385.  
  2386. 1_0_0_4_  T_h_e_r_e_  a_r_e_  t_o_o_  m_a_n_y_  v_a_l_u_e_s_ i_n_ t_h_e_ f_i_e_l_d_..  Some fields allow multiple
  2387. values to be entered, but, unless the menu indicates this, a field can contain
  2388. only one entry. If you do enter more  than  one  value,  adjacent  values  are
  2389. separated  by  commas  and/or  spaces. This message simply means that you have
  2390. more than the maximum number permitted.
  2391.  
  2392. 1_0_0_5_ T_h_i_s_ f_i_e_l_d_ c_a_n_n_o_t_ b_e_ l_e_f_t_ b_l_a_n_k_..  You  must  enter  something.  In  most
  2393. cases, this error will arise if you have erased a field that had an entry when
  2394. the  menu  was  first displayed. If you are not sure what to enter, simply re-
  2395. store the original value.
  2396.  
  2397. 1_0_0_6_ T_h_e_ n_u_m_b_e_r_ (o_r_ o_n_e_ o_f_ t_h_e_ n_u_m_b_e_r_s_) i_s_ t_o_o_ b_i_g_ o_r_ t_o_o_ s_m_a_l_l_..  The minimum
  2398. and maximum values permitted for the field are given in square  brackets  next
  2399. to  the  field.  If you have entered multiple values in the field, all numbers
  2400. must be within the given range.
  2401.  
  2402. 1_0_0_7_ T_h_e_r_e_ a_r_e_ n_o_ y_-v_a_l_u_e_s_ (n_u_m_e_r_i_c_ d_a_t_a_) i_n_ t_h_e_ i_n_p_u_t_ f_i_l_e_..  Every data file
  2403. must have at least two columns: one column of x's and one column of  y's.  The
  2404. x's  are  considered  to  be  words, or character values (even if they contain
  2405. numbers), and the y's must be numeric.
  2406.  
  2407. 1_0_0_8_ O_n_e_ o_f_ t_h_e_ y_-v_a_l_u_e_s_ i_n_ t_h_e_ i_n_p_u_t_ f_i_l_e_ i_s_ n_o_t_  n_u_m_e_r_i_c_..  Refer  to  error
  2408. message 1007.
  2409.  
  2410. 1_0_0_9_ T_h_i_s_ x_-v_a_l_u_e_ d_o_e_s_ n_o_t_ a_p_p_e_a_r_ i_n_ t_h_e_ i_n_p_u_t_ f_i_l_e_..  The value in this field
  2411. must  be  one  of the x values in your file, corresponding to the piece of the
  2412. pie you want to explode. Although The Draftsman  ignores  differences  due  to
  2413. capitalization, it cannot recognize abbreviations. If you want to look at your
  2414. file, go to menu 3 and select EDIT.
  2415.  
  2416. 1_0_1_0_  T_h_i_s_ f_i_l_e_ h_a_s_ n_o_t_ b_e_e_n_ c_r_e_a_t_e_d_ y_e_t_..  To draw a pie, bar, or line graph,
  2417. you must have some data to be plotted. Go back to menu 3 to create a file.
  2418.  
  2419. 1_0_1_1_ T_h_e_ f_i_l_e_ d_o_e_s_ n_o_t_ h_a_v_e_ t_h_i_s_ m_a_n_y_ c_o_l_u_m_n_s_..  This message tells  you  that
  2420. the  y  column  you selected (or one of the columns, if you selected more than
  2421. one) is greater than the number of columns of y's in the file.  While  a  file
  2422. can have up to five y columns, it need only have one.
  2423.  
  2424. 1_0_1_2_  T_h_i_s_  c_o_l_u_m_n_  h_a_s_ n_e_g_a_t_i_v_e_ v_a_l_u_e_s_, w_h_i_c_h_ c_a_n_'t_ b_e_ p_i_e_-d_..  To draw a pie
  2425. chart, all of the y values must be greater  than  or  equal  to  zero.  Either
  2426. select another column, or go back to menu 3 to edit the file.
  2427.  
  2428. 1_0_1_3_ T_h_i_s_ c_o_l_u_m_n_ h_a_s_ f_e_w_e_r_ t_h_a_n_ t_w_o_ p_o_s_i_t_i_v_e_ n_u_m_b_e_r_s_..  In order to draw a pie
  2429. chart,  The  Draftsman  needs  at  least two slices with y values greater than
  2430. zero.
  2431.  
  2432. 1_0_1_4_ I_f_ t_h_e_ s_i_z_e_ i_s_ g_i_v_e_n_, p_o_s_i_t_i_o_n_ - x_, y_ - m_u_s_t_ b_e_  g_i_v_e_n_  a_l_s_o_..  You  need
  2433. not  give  a  size  for  your  graph;  if  you leave the size field blank, The
  2434. Draftsman will automatically determine the size your graph requires (refer  to
  2435. the  discussion  of  boxing  in online help section 2.4.1). However, if you do
  2436. specify the size, you must give the position also, the x,y coordinates of  the
  2437. upper  left  hand corner of the plot area. The x-coordinate is in the range 0-
  2438.  
  2439.  
  2440. ______________________________________________________________________________
  2441. (c) 1985 by David J. Stang                                   Please Reproduce!
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447. User Manual for The Draftsman   Page 33
  2448. ______________________________________________________________________________
  2449.  
  2450.  
  2451.  
  2452. 319, and the y-coordinate is in the range 0-199. The  two  numbers  should  be
  2453. separated by a space or a comma.
  2454.  
  2455. 1_0_1_5_ T_h_e_ p_l_o_t_ a_r_e_a_ e_x_t_e_n_d_s_ b_e_y_o_n_d_ s_c_r_e_e_n_ s_i_z_e_..  This means that a square with
  2456. the  size and position you gave won't fit on the screen. Recall that the posi-
  2457. tion is the coordinates of the upper left hand corner of the square.
  2458.  
  2459. 1_0_1_6_ T_h_e_ p_l_o_t_ c_a_n_'t_ f_i_t_ i_n_ t_h_e_ s_i_z_e_  y_o_u_  g_a_v_e_..  Try  boxing.  Normally,  you
  2460. should  not  specify  a size for a chart. If the size field is left blank, The
  2461. Draftsman will automatically determine the minimum size required by the  chart
  2462. (refer  to the discussion of boxing in online help section 2.4.1). However, if
  2463. you return to make modifications  to  a  chart  you  previously  plotted,  The
  2464. Draftsman  will  have  inserted  the size and position which was used. If your
  2465. modifications make your plot bigger (e.g., you might make the  title  longer),
  2466. you  might  get  this error message. In this case, simply erase the size field
  2467. and let The Draftsman decide.
  2468.  
  2469. 1_0_1_8_ T_h_i_s_ i_s_ a_ n_u_l_l_ g_r_a_p_h_. A_l_l_ y_'s_ a_r_e_ e_q_u_a_l_ t_o_ t_h_e_ b_a_s_e_l_i_n_e_..  This  normally
  2470. means  that  all  y's are equal to zero. You have probably either: 1) selected
  2471. the wrong data; file, 2) selected the wrong y column, or 3) created  the  file
  2472. incorrectly. Return to menu 3 and use EDIT to take a look at the file.
  2473.  
  2474. 1_0_1_9_  T_h_e_  p_l_o_t_  i_s_  t_o_o_  b_i_g_ f_o_r_ t_h_e_ s_c_r_e_e_n_..  Shorten labels or values. This
  2475. problem can be corrected by: 1) shortening titles, labels,  or  footnotes,  2)
  2476. decreasing  the minimum column width to 8, 3) decreasing the number of charac-
  2477. ters in the x values (e.g., use J, F, M instead of  Jan,  Feb,;  Mar),  or  4)
  2478. changing to high resolution (go to menu 2).
  2479.  
  2480. 1_0_2_0_  N_o_ f_i_l_e_s_ w_e_r_e_ n_a_m_e_d_. Y_o_u_ m_u_s_t_ u_s_e_ a_t_ l_e_a_s_t_ o_n_e_ f_i_l_e_..  Disk files can be
  2481. named using either option 1 or option 2. Slide files are  saved  either  using
  2482. menu 6 or in edit mode (menu 4.4) with the o command.
  2483.  
  2484. 1_0_2_1_  Y_o_u_  c_a_n_'t_  h_a_v_e_  s_t_a_c_k_e_d_ b_a_r_s_ w_i_t_h_ n_e_g_a_t_i_v_e_ v_a_l_u_e_s_..  Normally, you use
  2485. stacked bars to show the relationship between parts of a whole.  For  example:
  2486. you  might  have  sales  from  four divisions, stacked into a single column to
  2487. represent total company sales. Certainly you can't have a negative share,  and
  2488. in any event The Draftsman can't draw it.
  2489.  
  2490. 1_0_2_2_ O_n_e_ o_f_ t_h_e_ c_o_l_o_r_s_ y_o_u_ s_p_e_c_i_f_i_e_d_ i_s_ n_o_t_ v_a_l_i_d_..  The valid colors 0-15, or
  2491. a  subset,  are  listed  below  the  color  field in the menu. For bar or line
  2492. charts, you can add 100 to a color number to obtain dot shading,  or  200  for
  2493. line shading.
  2494.  
  2495. 1_0_2_3_  N_o_  p_l_o_t_  h_a_s_ b_e_e_n_ c_r_e_a_t_e_d_ y_e_t_..  Use menus 3 and 4 to do so. This error
  2496. will arise if you attempt to generate a plot on the pen plotter before  creat-
  2497. ing  the  plot  on the screen. Note that you cannot plot a graph unless it has
  2498. been drawn in the current session. For example,  you  cannot  fetch  a  screen
  2499. image from disk (using the i option in edit) and proceed to plot it.
  2500.  
  2501. 1_0_2_4_  Y_o_u_  h_a_v_e_ r_u_n_ o_u_t_ o_f_ m_e_m_o_r_y_. U_n_r_e_c_o_v_e_r_a_b_l_e_ e_r_r_o_r_..  This error may arise
  2502. in drawing particuarly complex graphs. Try reducing the number of  graph  com-
  2503. ponents.
  2504.  
  2505.  
  2506. ______________________________________________________________________________
  2507. (c) 1985 by David J. Stang                                   Please Reproduce!
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513. User Manual for The Draftsman   Page 34
  2514. ______________________________________________________________________________
  2515.  
  2516.  
  2517.  
  2518. 1_0_3_1_  Y_o_u_  h_a_v_e_  r_u_n_  o_u_t_ o_f_ m_e_m_o_r_y_. S_a_v_e_ w_h_a_t_ y_o_u_ c_a_n_ a_n_d_ s_t_a_r_t_ a_g_a_i_n_..  This
  2519. error message may appear when constructing complex graphs. You can use menu  6
  2520. to  save all data files, the current chart, and all graph specifications. Then
  2521. exit from The Draftsman by choosing 9 from the main menu.
  2522.  
  2523. 1_0_3_2_ T_h_e_ f_i_l_e_ y_o_u_ n_a_m_e_d_ w_a_s_ n_o_t_ f_o_u_n_d_..  Could the drive be wrong? Unlike some
  2524. software packages, The Draftsman makes no assumptions about  file  names.  For
  2525. example,  if  you  have  a file named MONTH.DAT, and you enter MONTH, the file
  2526. won't be located. If you don't enter  a  drive  specification,  The  Draftsman
  2527. assumes  that  the  file is on the current default drive (normally A). If your
  2528. file is not on this drive, you must enter a drive  prefix.  If  you  are  ever
  2529. unsure what to enter, give the full name, e.g., B:MONTH.DAT.
  2530.  
  2531. 1_0_3_3_  T_h_e_  d_i_s_k_  y_o_u_  t_r_i_e_d_  t_o_  s_a_v_e_  t_o_  i_s_ f_u_l_l_..  Insert another. Once The
  2532. Draftsman is loaded, you can remove the A diskette. You can  then  use  the  A
  2533. drive for all data files. If one becomes full (this will normally occur if you
  2534. save  a  lot  of  screen  images; each one takes 4,000 - 10,000 bytes) you can
  2535. simply insert another.
  2536.  
  2537. 1_0_3_4_ E_i_t_h_e_r_ a_ d_i_s_k_ d_r_i_v_e_ o_r_ t_h_e_ p_r_i_n_t_e_r_ i_s_ u_n_a_v_a_i_l_a_b_l_e_..  The  Draftsman  only
  2538. knows  that  some device is unavailable. You should be able to determine which
  2539. device is at fault. if you were using menu 5, the printer  is  needed,  other-
  2540. wise, one of the disk drives is not ready.
  2541.  
  2542. 1_0_3_5_  I_n_p_u_t_/O_u_p_u_t_ e_r_r_o_r_..  An error was encountered in transmitting data to or
  2543. from your disk. Your disk may be defective; try your last operation again.
  2544.  
  2545. 1_0_3_6_ Y_o_u_ t_r_i_e_d_ t_o_ w_r_i_t_e_ t_o_ a_ p_r_o_t_e_c_t_e_d_ d_i_s_k_..  Disks are write-protected  with
  2546. a  shiny  adhesize strip. This insures against accidental destruction of data.
  2547. If you have write-protected your program disk, then tried to save to it,  this
  2548. error will occur. Probably you shouldn't be trying to write to such a disk.
  2549.  
  2550. 1_0_3_7_  T_h_e_  f_i_l_e_  n_a_m_e_  y_o_u_  g_a_v_e_ i_s_ i_n_v_a_l_i_d_..  File names can have from one to
  2551. three parts, as follows: an optional drive designation  (a:,  b:,  or  c:),  a
  2552. required  primary  name (1 to 8 characters consisting of letters and numbers),
  2553. and an optional qualifier (a period followed by 1 to 3 characters).
  2554.  
  2555. 1_0_3_8_ T_h_e_ f_i_l_e_ y_o_u_ n_a_m_e_d_ i_s_ i_n_  a_n_  u_n_r_e_c_o_g_n_i_z_a_b_l_e_  f_o_r_m_a_t_..  This  error  will
  2556. arise  for one of two reasons: 1) either you are attempting to read a DIF file
  2557. and the file is not in DIF  format,  or  2)  you  are  attempting  to  read  a
  2558. DRAFTSMAN  spec  file, and the file was not saved as a spec file. You probably
  2559. gave the wrong file name.
  2560.  
  2561. 1_0_3_9_ T_h_e_ # o_f_ r_o_w_s_ (o_r_ c_o_l_u_m_n_s_) i_n_ t_h_e_ f_i_l_e_ i_s_ e_i_t_h_e_r_ 0_ o_r_ t_o_o_ l_a_r_g_e_..  A data
  2562. file can have at most 24 rows and 5 columns of y values. This error may  arise
  2563. if you are reading a file which is not in the proper format.
  2564.  
  2565.  
  2566.                               15.  Installation
  2567.  
  2568.  
  2569.  
  2570.  
  2571.  
  2572. ______________________________________________________________________________
  2573. (c) 1985 by David J. Stang                                   Please Reproduce!
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579. User Manual for The Draftsman   Page 35
  2580. ______________________________________________________________________________
  2581.  
  2582.  
  2583.  
  2584. 15.1  E_q_u_i_p_m_e_n_t_ R_e_q_u_i_r_e_d_
  2585.  
  2586. In  order  to use The Draftsman, you need the following minimum configuration:
  2587. 1) two disk drives, 2) 128K of  memory  (160K  is  recommended),  3)  the  IBM
  2588. color/graphics monitor adapter or compatible adapter (although not necessarily
  2589. a color monitor) and 4) DOS 1.1 or higher.
  2590.  
  2591.  
  2592. 15.2  F_o_r_ N_e_w_ C_o_m_p_u_t_e_r_ U_s_e_r_s_ O_n_l_y_
  2593.  
  2594.  
  2595.  
  2596. 15.2.1  Diskette  Care.  Diskettes  store  both programs and data. If they are
  2597. damaged, all of the information on them may be lost. Here are some basic rules
  2598. to follow to prevent damage to your diskettes.
  2599.  
  2600.  1. Loading: To load a diskette into a disk drive, carefully  remove  it  from
  2601.     its  jacket, and insert it into the open disk drive door. The label should
  2602.     go in last, and should face up (if your drive door is  horizontal)  or  to
  2603.     the left (if your door is vertical).
  2604.  
  2605.  2. Labeling:  Be  certain  to  label all diskettes. Use a felt-tip pen. Place
  2606.     labels only on the top side of the diskette at the end away from the  oval
  2607.     read-write surface.
  2608.  
  2609.  3. Backup:  Make  backup copies of your master program disks before you begin
  2610.     work; Put your master copy away in a  safe  place,  and  use  the  backup.
  2611.     Backup  your data diskettes daily. Label your masters "master", your work-
  2612.     ing copies "working", and your extra backups "backup". Store  backups  and
  2613.     masters in a separate location from that used to store working copies.
  2614.  
  2615.  4. Storage:  Keep  all diskettes in their protective jackets when not in use,
  2616.     and place them in  a  safe  place  away  from  heat,  moisture,  solvents,
  2617.     cigarette ashes, dust, x-rays, and magnetic fields. Store diskettes verti-
  2618.     cally;  do  not pack them into containers, or do anything that might crimp
  2619.     them.
  2620.  
  2621.  5. Handling: Only hold disketes by the label end.  Never  touch  the  exposed
  2622.     surface  of  the  disk with a finger or other object. Never fold or bend a
  2623.     diskette.
  2624.  
  2625.  
  2626.  
  2627. 15.3  M_a_k_e_ a_ B_a_c_k_u_p_ C_o_p_y_
  2628.  
  2629. To make a backup of your program disk, follow these steps:
  2630.  
  2631.  1. Insert a blank disk in drive B:, your DOS  disk  in  drive  A:.  Turn  the
  2632.     computer on.
  2633.  
  2634.  2. Enter  the  time and date. At the A> , do a directory of the disk in drive
  2635.     B: to make sure it is blank or contains files you do not care about.
  2636.  
  2637.  
  2638. ______________________________________________________________________________
  2639. (c) 1985 by David J. Stang                                   Please Reproduce!
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645. User Manual for The Draftsman   Page 36
  2646. ______________________________________________________________________________
  2647.  
  2648.  
  2649.  
  2650.     A>DIR B:
  2651.  
  2652.  
  2653.  3. Format the disk in drive B:, transferring the operating system at the same
  2654.     time. Enter:
  2655.  
  2656.     A>FORMAT B:/S
  2657.  
  2658.  
  2659.  4. Now copy The Draftsman to drive B:. Remove your DOS diskette from  A:  and
  2660.     insert your The Draftsman disk in A:. Copy all files, as follows:
  2661.  
  2662.     A>COPY *.* B:/v
  2663.  
  2664.  
  2665.  5. Proceed to the next section, modifying your working copy of The Draftsman.
  2666.  
  2667.  
  2668.  
  2669. 15.4  I_n_v_o_k_i_n_g_ T_h_e_ D_r_a_f_t_s_m_a_n_
  2670.  
  2671. Invoking The Draftsman requires three steps:
  2672.  
  2673.  1. Boot DOS from drive A.
  2674.  
  2675.  2. The  files  for  The  Draftsman  are  on one or two disks. You should make
  2676.     working copies of the originals and put the originals  in  a  safe  place.
  2677.     Refer  to  your DOS manual for instructions on making copies of diskettes.
  2678.     The working copy of the The Draftsman diskette marked  A  should  also  be
  2679.     formatted  with  DOS  (use FORMAT with the /s option). This will eliminate
  2680.     some disk switching later.
  2681.  
  2682.  3. Put the disk marked A in the A drive and the file marked B in the B drive.
  2683.     Type DRAWMAN and you're off and running. It takes a few  seconds  for  The
  2684.     Draftsman  to  load  its  files, so be patient. Once the MAIN MENU is dis-
  2685.     played, you can remove the disk from  drive  A  and  insert  another  disk
  2686.     containing (or to receive) data.
  2687.  
  2688. If  you  have double sided drives, a hard disk, or an electronic disk, you can
  2689. change the configuration above, but you need to understand what files comprise
  2690. The Draftsman and what they're used for. FILE.DAT may  need  to  be  modified.
  2691. (See below.)
  2692.  
  2693.  
  2694. 15.5  T_h_e_ D_r_a_f_t_s_m_a_n_ F_i_l_e_s_
  2695.  
  2696.  
  2697.  1. DRAWMAN.EXE  This  is  main program for The Draftsman. Once the program is
  2698.     loaded and the main menu appears, the diskette containing this file can be
  2699.     removed.
  2700.  
  2701.  2. FILE.DAT This is a pointer file which gives the names and locations of the
  2702.  
  2703.  
  2704. ______________________________________________________________________________
  2705. (c) 1985 by David J. Stang                                   Please Reproduce!
  2706.  
  2707.  
  2708.  
  2709.  
  2710.  
  2711. User Manual for The Draftsman   Page 37
  2712. ______________________________________________________________________________
  2713.  
  2714.  
  2715.  
  2716.     remaining five files. This file contains  five  records,  discussed  in  a
  2717.     later  section. If you change your configuration, FILE.DAT must be edited.
  2718.     It need not remain resident after The Draftsman begins execution.
  2719.  
  2720.  3. MENU.DAT This contains information about the menus.  It  need  not  remain
  2721.     resident.
  2722.  
  2723.  4. HELP.DAT This contains help. It must remain resident.
  2724.  
  2725.  5. VIO.DAT  This  file  contains  program segments which may be loaded during
  2726.     execution. It must remain resident.
  2727.  
  2728.  6. ERROR.DAT This file contains the error messages. It need not remain  resi-
  2729.     dent.
  2730.  
  2731.  7. WORK.DAT  This  is  used  as a work file when using the HP plotter or when
  2732.     producing a slide show. It need not be resident.
  2733.  
  2734.  8. DRAWMAN.DOC This is this manual. It need not be on  the  program  or  data
  2735.     disks.  You  will  want  to include it when you share The Draftsman with a
  2736.     friend.
  2737.  
  2738.  
  2739.  
  2740. 15.6  M_o_d_i_f_y_ F_I_L_E_.D_A_T_
  2741.  
  2742. The Draftsman may be run from either a floppy or your hard disk.  Instructions
  2743. for both options are provided below.
  2744.  
  2745. FILE.DAT specifies where DRAWMAN should look for the other files. You may view
  2746. it by entering: A>TYPE FILE.DAT It looks like this:
  2747.  
  2748.                       ---=== _T_a_b_l_e_ 1_5_: F_I_L_E_.D_A_T__ ===---
  2749.      n:menu.dat      (n should be c if you wish to run from
  2750.      n:help.dat       your hard disk. n should be a if you
  2751.      n:vio.dat        plan to run from drive a. Use an editor
  2752.      n:error.dat      to make the changes you may need to
  2753.      n:work.dat       in FILE.DAT)
  2754.               -------------------------------------------------------
  2755.  
  2756. Note that the file VIO.DAT is V-I(eye, not one)-O(oh, not zero).
  2757.  
  2758.  
  2759. 15.6.1  Running The Draftsman From a Floppy.  Unless your floppy disk can only
  2760. hold  320  Kb, you can place all of The Draftsman files on a single floppy. If
  2761. you want to run The Draftsman from a 360K floppy, FILE.DAT  should  look  like
  2762. this:
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.  
  2770. ______________________________________________________________________________
  2771. (c) 1985 by David J. Stang                                   Please Reproduce!
  2772.  
  2773.  
  2774.  
  2775.  
  2776.  
  2777. User Manual for The Draftsman   Page 38
  2778. ______________________________________________________________________________
  2779.  
  2780.  
  2781.  
  2782.         ---=== _T_a_b_l_e_ 1_6_: F_I_L_E_.D_A_T_ f_o_r_ F_l_o_p_p_y_-B_a_s_e_d_ O_p_e_r_a_t_i_o_n__ ===---
  2783.      a:menu.dat
  2784.      a:help.dat
  2785.      a:vio.dat
  2786.      a:error.dat
  2787.      a:work.dat
  2788.               -------------------------------------------------------
  2789.  
  2790. You can use your word processor to create this file.
  2791.  
  2792. If  you  want  to  run  The  Draftsman on a floppy with only 320K (DOS 1.1 and
  2793. earlier), you will need to place one or more of the above files on  drive  B:.
  2794. Drive  A:  must  contain  DRAWMAN.EXE  and FILE.DAT. All other files may go in
  2795. drive B: if you wish. If you wish to do this, change a: to b: in each  of  the
  2796. five  FILE.DAT  file  references  shown above. Your new FILE.DAT can look like
  2797. that shown below:
  2798.  
  2799.         a:menu.dat
  2800.         b:help.dat
  2801.         b:vio.dat
  2802.         a:error.dat
  2803.         a:work.dat
  2804.  
  2805. After you have modified FILE.DAT as needed to tell The Draftsman where to look
  2806. for program files, and before running The Draftsman, place a write-protect tab
  2807. on the notch of your working program disk, to prevent accidents to any of  The
  2808. Draftsman programs.
  2809.  
  2810. Before beginning work with The Draftsman, be certain you have a formatted data
  2811. diskette for use in drive B:
  2812.  
  2813.  
  2814. 15.6.2  Running  The  Draftsman from a Hard Disk.  The Draftsman will run much
  2815. faster from a hard disk, particularly during slide show operation. To run from
  2816. a hard disk, I would suggest that you follow these steps:
  2817.  
  2818.  1. Create a directory called DRAWMAN.
  2819.  
  2820.     C:MD\DRAWMAN
  2821.  
  2822.  
  2823.  2. Enter the new DRAWMAN directory:
  2824.  
  2825.     C:CD\DRAWMAN
  2826.  
  2827.  
  2828.  3. Copy all files for The Draftsman to this directory:
  2829.  
  2830.     C:copy a:*.* /v
  2831.  
  2832.  
  2833.  4. Edit FILE.DAT, if necessary, to read as follows:
  2834.  
  2835.  
  2836. ______________________________________________________________________________
  2837. (c) 1985 by David J. Stang                                   Please Reproduce!
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  
  2843. User Manual for The Draftsman   Page 39
  2844. ______________________________________________________________________________
  2845.  
  2846.  
  2847.  
  2848.     c:menu.dat
  2849.     c:help.dat
  2850.     c:vio.dat
  2851.     c:error.dat
  2852.     c:work.dat
  2853.  
  2854.  
  2855.  
  2856. 15.7  F_o_r_ U_s_e_r_s_ w_i_t_h_ M_o_n_o_c_h_r_o_m_e_ M_o_n_i_t_o_r_s_
  2857.  
  2858. The Draftsman is configured for a color monitor. On some monochrome (amber  or
  2859. green)  monitors, the display is unreadable after booting. You can remedy this
  2860. problem by changing the color combinations used by the program.  Here  is  the
  2861. sequence you must enter:
  2862.  
  2863. DRAWMAN (this will load The Draftsman)
  2864.  
  2865. 2       (select menu option 2, Define Environment)
  2866.  
  2867. F2      (move into this menu)
  2868.  
  2869. RETURN  (skip the first question)
  2870.  
  2871. RETURN  (skip the second question)
  2872.  
  2873. RETURN  (skip the third question)
  2874.  
  2875. 07      (change text color to white)
  2876.  
  2877. RETURN  (move to next question)
  2878.  
  2879. 15      (change background color to hi-intensity white)
  2880.  
  2881. RETURN  (move to next question)
  2882.  
  2883. 15      (change foreground color to hi-intensity white)
  2884.  
  2885. RETURN  (move to next question)
  2886.  
  2887. 0       (change to black)
  2888.  
  2889. RETURN  (move to next question)
  2890.  
  2891. 0       (change to black)
  2892.  
  2893. RETURN  (move to next question)
  2894.  
  2895. F2      (accept your changes and return to main menu)
  2896.  
  2897. If The Draftsman is still difficult to read on your monitor, repeat steps 2-17
  2898. above, but substitute 15 for 07, and 07 for 15.
  2899.  
  2900.  
  2901.  
  2902. ______________________________________________________________________________
  2903. (c) 1985 by David J. Stang                                   Please Reproduce!
  2904.  
  2905.  
  2906.  
  2907.  
  2908.  
  2909. User Manual for The Draftsman   Page 40
  2910. ______________________________________________________________________________
  2911.  
  2912.  
  2913.  
  2914. 15.8  A_s_s_u_r_i_n_g_ Y_o_u_ H_a_v_e_ a_ F_u_l_l_ C_o_p_y_ o_f_ T_h_e_ D_r_a_f_t_s_m_a_n_
  2915.  
  2916.  
  2917.           ---=== _T_a_b_l_e_ 1_7_: F_i_l_e_s_ R_e_q_u_i_r_e_d_ b_y_ T_h_e_ D_r_a_f_t_s_m_a_n__ ===---
  2918.      The Draftsman requires these files for operation:
  2919.  
  2920.       DRAWMAN  EXE   100096 - the main program
  2921.       HELP     DAT    64512 - a file of help messages
  2922.       VIO      DAT    92160 - additional program segments
  2923.       MENU     DAT    15360 - information about the menus
  2924.       ERROR    DAT     1920 - error messages
  2925.       WORK     DAT    16384 - a work file used for slide shows, plotting
  2926.       FILE     DAT       60 - a pointer file
  2927.               -------------------------------------------------------
  2928.  
  2929.  
  2930.  
  2931. 15.9  I_n_s_t_a_l_l_i_n_g_ a_ M_o_u_s_e_ D_r_i_v_e_r_
  2932.  
  2933. You  can  install a driver for the Mouse Systems mouse by copying the MOUSESYS
  2934. program to your Draftsman disk, and entering  mousesys/r.  Here  is  a  simple
  2935. batch  file that does the job, and explains the operation of the Mouse Systems
  2936. mouse with The Draftsman:
  2937.  
  2938.            ---=== _T_a_b_l_e_ 1_8_: M_o_u_s_e_ I_n_s_t_a_l_l_a_t_i_o_n_ B_a_t_c_h_ F_i_l_e__ ===---
  2939.      echo off
  2940.      mousesys/r
  2941.      echo Your Mouse Systems mouse has now been installed to work with
  2942.      echo             The Draftsman.
  2943.      echo .
  2944.      echo Button 1 is the same as F1 (context-sensitive help)
  2945.      echo Button 2 is the same as F2 (forward to next screen)
  2946.      echo Button 3 is the same as F3 (back to last screen)
  2947.      echo .
  2948.      echo Up and Down movements will move between menu items.
  2949.      echo Left and Right movements will move within a menu item.
  2950.      echo .
  2951.      echo In Plot mode, all mouse motions will translate to cursor
  2952.      echo    motions.
  2953.      echo In Plot mode, you may fine tune the mouse sensitivity with
  2954.      echo the < and > keys, return to normal with =
  2955.      pause Have fun!
  2956.      drawman.exe
  2957.               -------------------------------------------------------
  2958.  
  2959.  
  2960.  
  2961. 15.10  H_P_ 7_4_7_0_A_ P_l_o_t_t_e_r_
  2962.  
  2963. The switch settings on the plotter should be as follows:
  2964.                             0  0  0  1  1  0  0  0
  2965.                            S1 S2 Y  US B4 B3 B2 B1
  2966.  
  2967.  
  2968. ______________________________________________________________________________
  2969. (c) 1985 by David J. Stang                                   Please Reproduce!
  2970.  
  2971.  
  2972.  
  2973.  
  2974.  
  2975. User Manual for The Draftsman   Page 41
  2976. ______________________________________________________________________________
  2977.  
  2978.  
  2979.  
  2980. This setting indicates no parity (S1=0), 8 1/2 x 11 paper (US), and 2400  BAUD
  2981. data rate (the B's).
  2982.  
  2983.  
  2984.  
  2985.                             16.  Support for Users
  2986.  
  2987. Since  you  did  not  pay  for  The Draftsman, limited support for the product
  2988. should be expected.
  2989.  
  2990.  
  2991. 16.1  2_4_-H_o_u_r_ B_B_S_ S_u_p_p_o_r_t_
  2992.  
  2993. Some support may be obtained from a bulletin board (BBS) which  you  may  call
  2994. with  your  computer.  The number is (202) 686-5360. It supports 300/1200 baud
  2995. operation, and operates 24 hours a day, 7 days a week. There is no charge  for
  2996. accessing the BBS.
  2997.  
  2998. One feature of the board will be product updates and enhancements. The current
  2999. version  of the product may be downloaded from this board. Any improvements to
  3000. this manual will also be available from this board. I expect to have a  number
  3001. of boiler-plate slide libraries available for your download, as well.
  3002.  
  3003. Another  feature  of  this board will be general problem-solving, tips for ad-
  3004. vanced use, and the like. If you have any problem using The Draftsman (program
  3005. errors, for instance) or if you  have  suggestions  for  improvements  of  the
  3006. program or this manual, call the board and leave a message.
  3007.  
  3008.  
  3009.  
  3010. 16.2  S_u_p_p_o_r_t_ f_o_r_ R_e_g_i_s_t_e_r_e_d_ U_s_e_r_s_
  3011.  
  3012. If  you  send  a contribution for $25 or more, or send a note assuring me that
  3013. you have distributed The Draftsman to 5 or more other users, I will  add  your
  3014. name as a registered owner of The Draftsman. Registered users will be added to
  3015. the  newsletter  mailing  list,  and will be notified when slide libraries and
  3016. program enhancements become available.
  3017.  
  3018.  
  3019. 16.3  S_o_u_r_c_e_ C_o_d_e_ A_v_a_i_l_a_b_l_e_
  3020.  
  3021. Source code for The Draftsman is available for $2000. The fee grants  you  the
  3022. right  to  make  any  changes or enhancements you wish for use within your or-
  3023. ganization. It does not grant you the right, however, to sell The Draftsman.
  3024.  
  3025.  
  3026. 16.4  D_i_s_t_r_i_b_u_t_i_o_n_ C_o_n_d_i_t_i_o_n_s_
  3027.  
  3028. The Draftsman is distributed with these conditions:
  3029.  
  3030.  1. David Stang holds the copyright.  No  permission  to  modify  any  of  The
  3031.     Draftsman programs is granted.
  3032.  
  3033.  
  3034. ______________________________________________________________________________
  3035. (c) 1985 by David J. Stang                                   Please Reproduce!
  3036.  
  3037.  
  3038.  
  3039.  
  3040.  
  3041. User Manual for The Draftsman   Page 42
  3042. ______________________________________________________________________________
  3043.  
  3044.  
  3045.  
  3046.  2. The  Draftsman  is  not to be sold. No consideration is to be paid for its
  3047.     distribution, except for nominal copying charges.
  3048.  
  3049.  3. The Draftsman is to be shared freely  with  anyone  who  may  find  it  of
  3050.     benefit.
  3051.  
  3052.  4. Happy  users,  who  find The Draftsman of value, should consider sending a
  3053.     contribution to David Stang  c/o  Hire  Education,  3631  Jenifer  St  NW,
  3054.     Washington DC 20015
  3055.  
  3056.  
  3057.  
  3058. 16.5  H_i_s_t_o_r_y_ o_f_ T_h_e_ D_r_a_f_t_s_m_a_n_
  3059.  
  3060. The  Draftsman  was  written  by  Jan  Gombert while employed by David Stang's
  3061. company Starware. The Draftsman enjoyed some commercial  success  (Plantronics
  3062. licensed a version of it for their graphics card; it was favorably reviewed in
  3063. many  micro  magazines;  a  large number of copies of the program were sold at
  3064. $200), but Starware did not. Since completing The Draftsman,  Jan  has  formed
  3065. Softwriters,  a  software  house  best  known for Halo and Dr. Halo. David now
  3066. earns his living by giving seminars on  microcomputers.  They  plan  to  share
  3067. evenly  in  any  contributions  received from the freeware distribution of The
  3068. Draftsman.
  3069.  
  3070.  
  3071.  
  3072.  
  3073.  
  3074.  
  3075.  
  3076.  
  3077.  
  3078.  
  3079.  
  3080.  
  3081.  
  3082.  
  3083.  
  3084.  
  3085.  
  3086.  
  3087.  
  3088.  
  3089.  
  3090.  
  3091.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.  
  3098.  
  3099.  
  3100. ______________________________________________________________________________
  3101. (c) 1985 by David J. Stang                                   Please Reproduce!
  3102.  
  3103.  
  3104.  
  3105.  
  3106.  
  3107.  
  3108.  
  3109. User Manual for The Draftsman 
  3110. ______________________________________________________________________________
  3111.  
  3112.                    Index for User Manual for The Draftsman
  3113.  
  3114.  + ..................................................................... 2
  3115.  + Command (Legends) .................................................. 23
  3116.  - ..................................................................... 2
  3117.  - Command - Slide Show ............................................... 30
  3118.  1-2-3 as Data Source ................................................. 12
  3119.  1001 An unrecoverable error has occurred. Contact your dealer. ....... 31
  3120.  1002 The entry(s) have to be numbers (without commas or $ signs). .... 31
  3121.  1003 The entry is not spelled correctly. ............................. 31
  3122.  1004 There are too many values in the field. ......................... 32
  3123.  1005 This field cannot be left blank. ................................ 32
  3124.  1006 The number (or one of the numbers) is too big or too small. ..... 32
  3125.  1007 There are no y-values (numeric data) in the input file. ......... 32
  3126.  1008 One of the y-values in the input file is not numeric. ........... 32
  3127.  1009 This x-value does not appear in the input file. ................. 32
  3128.  1010 This file has not been created yet. ............................. 32
  3129.  1011 The file does not have this many columns. ....................... 32
  3130.  1012 This column has negative values, which can't be pie-d. .......... 32
  3131.  1013 This column has fewer than two positive numbers. ................ 32
  3132.  1014 If the size is given, position - x, y - must be given also. ..... 32
  3133.  1015 The plot area extends beyond screen size. ....................... 33
  3134.  1016 The plot can't fit in the size you gave. ........................ 33
  3135.  1018 This is a null graph. All y's are equal to the baseline. ........ 33
  3136.  1019 The plot is too big for the screen. ............................. 33
  3137.  1020 No files were named. You must use at least one file. ............ 33
  3138.  1021 You can't have stacked bars with negative values. ............... 33
  3139.  1022 One of the colors you specified is not valid. ................... 33
  3140.  1023 No plot has been created yet. ................................... 33
  3141.  1024 You have run out of memory. Unrecoverable error. ................ 33
  3142.  1031 You have run out of memory. Save what you can and start again. .. 34
  3143.  1032 The file you named was not found. ............................... 34
  3144.  1033 The disk you tried to save to is full. .......................... 34
  3145.  1034 Either a disk drive or the printer is unavailable. .............. 34
  3146.  1035 Input/Ouput error. .............................................. 34
  3147.  1036 You tried to write to a protected disk. ......................... 34
  3148.  1037 The file name you gave is invalid. .............................. 34
  3149.  1038 The file you named is in an unrecognizable format. .............. 34
  3150.  1039 The # of rows (or columns) in the file is either 0 or too large.  34
  3151.  24-Hour BBS Support .................................................. 41
  3152.  < Command ............................................................ 21
  3153.  = Command ............................................................ 21
  3154.  > Command ............................................................ 21
  3155.  a Command ............................................................ 21
  3156.  Add a Legend ......................................................... 22
  3157.  Add Text ............................................................. 21
  3158.  Amdek Color II ........................................................ 7
  3159.  Aspect Ratio - Plotter ............................................... 28
  3160.  Aspect Ratio - Printer ............................................... 25
  3161.  Assuring You Have a Full Copy of The Draftsman ....................... 39
  3162.  B Command ............................................................ 22
  3163.  b Command ............................................................ 22
  3164.  Back Up your Screen to Disk .......................................... 23
  3165.  Backup ............................................................... 35
  3166.  Backups - Making ..................................................... 35
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172. User Manual for The Draftsman 
  3173. ______________________________________________________________________________
  3174.  
  3175.  Bar Chart Menu ....................................................... 16
  3176.  Bar Chart Specifications ............................................. 16
  3177.  Bar Colors ........................................................... 17
  3178.  Bar Format ........................................................... 17
  3179.  Bar Width ............................................................ 18
  3180.  Baseline Value ....................................................... 18
  3181.  BBS Support .......................................................... 41
  3182.  Boxing ............................................................... 15
  3183.  c Command ............................................................ 23
  3184.  Change Color ......................................................... 22
  3185.  Chart Size and Position .............................................. 18
  3186.  Chart Size and Position (boxing) ..................................... 15
  3187.  Clustered Bars ....................................................... 17
  3188.  Comma Delimited Files ................................................. 9
  3189.  Connect Points ....................................................... 19
  3190.  Constructing a Graph .................................................. 2
  3191.  Ctrl-Break ........................................................... 14
  3192.  Ctrl-End .............................................................. 4
  3193.  Cursor Down ........................................................... 3
  3194.  Cursor left/right ..................................................... 4
  3195.  Cursor Motion Keys .................................................... 3
  3196.  Cursor Up ............................................................. 3
  3197.  d Command ............................................................ 21
  3198.  Data ................................................................. 28
  3199.  DATA .................................................................. 9
  3200.  Data Entry Menu ....................................................... 9
  3201.  Data File ............................................................ 15
  3202.  Data File ............................................................ 18
  3203.  Define Environment .................................................... 6
  3204.  Define Environment Menu ............................................... 6
  3205.  Del ................................................................... 4
  3206.  DIF ................................................................... 9
  3207.  DIF Creation from 1-2-3 .............................................. 12
  3208.  Disk Full ............................................................ 34
  3209.  Diskette Care ........................................................ 35
  3210.  Diskette File Name ................................................... 29
  3211.  Display Slide Show ................................................... 29
  3212.  Distribution Conditions .............................................. 41
  3213.  Draw a Circle (or Oval) .............................................. 23
  3214.  Draw a Flowchart ..................................................... 23
  3215.  Draw a Line .......................................................... 21
  3216.  Draw a Rectangle ..................................................... 22
  3217.  Draw an Arrow ........................................................ 21
  3218.  DRAWMAN.DOC .......................................................... 37
  3219.  DRAWMAN.EXE .......................................................... 36
  3220.  DRAWMAN.EXE .......................................................... 38
  3221.  E Command ............................................................ 24
  3222.  e Command ............................................................ 24
  3223.  E Command - Plotting ................................................. 27
  3224.  e Command - Plotting ................................................. 27
  3225.  Edit ................................................................. 20
  3226.  Edit .................................................................. 8
  3227.  Edit Command Summary ................................................. 20
  3228.  Edit:Filen ........................................................... 11
  3229.  Enclose Chart in Box ................................................. 17
  3230.  Enter (Return) ........................................................ 3
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238. User Manual for The Draftsman 
  3239. ______________________________________________________________________________
  3240.  
  3241.  Epson ................................................................ 25
  3242.  Equipment Required ................................................... 34
  3243.  Erase a Line ......................................................... 24
  3244.  Erase a Region ....................................................... 24
  3245.  Error Messages ....................................................... 31
  3246.  ERROR.DAT ............................................................ 37
  3247.  Execute Saved Edit Commands .......................................... 21
  3248.  Explode .............................................................. 15
  3249.  f Command ............................................................ 22
  3250.  F1 Function Key ...................................................... 21
  3251.  F1 Function Key ....................................................... 3
  3252.  F2 Function Key ....................................................... 3
  3253.  F3 Function Key ....................................................... 3
  3254.  F4 Function Key ...................................................... 13
  3255.  F5 Function Key ...................................................... 21
  3256.  F6 Function Key ...................................................... 22
  3257.  Features of The Draftsman ............................................. 1
  3258.  Field Editing Keys .................................................... 3
  3259.  Fields in Menus ....................................................... 3
  3260.  File Directories - Listing ........................................... 31
  3261.  File Formats ......................................................... 34
  3262.  File Names ........................................................... 11
  3263.  File Names ........................................................... 34
  3264.  File Not Found ....................................................... 34
  3265.  File Number .......................................................... 10
  3266.  File Number and Format ............................................... 29
  3267.  FILE.DAT ............................................................. 36
  3268.  FILE.DAT ............................................................. 37
  3269.  FILE.DAT ............................................................. 37
  3270.  FILE.DAT ............................................................. 38
  3271.  FILE.DAT for Floppy-Based Operation .................................. 38
  3272.  Files Required by The Draftsman ...................................... 40
  3273.  Find Out Where You Are ............................................... 21
  3274.  For New Computer Users Only .......................................... 35
  3275.  For Users with Monochrome Monitors ................................... 39
  3276.  Free Computer Memory Indicator ........................................ 4
  3277.  General Overview ...................................................... 2
  3278.  General Plot Specifications .......................................... 12
  3279.  General Plot Specifications Menu ..................................... 13
  3280.  Get Help ............................................................. 21
  3281.  Graphics Resolution ................................................... 6
  3282.  Graphing Values from 1-2-3 ........................................... 11
  3283.  H Command ............................................................ 22
  3284.  h Command ............................................................ 22
  3285.  Handling Disks ....................................................... 35
  3286.  Hard Disk Operation .................................................. 38
  3287.  HELP.DAT ............................................................. 37
  3288.  Hi (graphics resolution) .............................................. 6
  3289.  History of The Draftsman ............................................. 42
  3290.  Horizontal Reference Value ........................................... 17
  3291.  HP 7470A Plotter ..................................................... 40
  3292.  HP-7470 .............................................................. 25
  3293.  i Command ............................................................ 23
  3294.  Input ................................................................ 26
  3295.  Ins ................................................................... 4
  3296.  Installation ......................................................... 34
  3297.  
  3298.  
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304. User Manual for The Draftsman 
  3305. ______________________________________________________________________________
  3306.  
  3307.  Installing a Mouse Driver ............................................ 40
  3308.  Invoking The Draftsman ............................................... 36
  3309.  l Command ............................................................ 21
  3310.  Labeling Disks ....................................................... 35
  3311.  Leave Edit ........................................................... 21
  3312.  Legend Creation ...................................................... 23
  3313.  Line Graph Menu ...................................................... 19
  3314.  Line Graph Specifications ............................................ 18
  3315.  Line Markers ......................................................... 19
  3316.  List File Directory .................................................. 31
  3317.  List File Directory Menu ............................................. 31
  3318.  Lo (graphics resolution) .............................................. 6
  3319.  m Command ............................................................ 24
  3320.  Main Menu ............................................................. 5
  3321.  Make a Backup Copy ................................................... 35
  3322.  Markers for Lines .................................................... 19
  3323.  Memory - Reducing Requirements ........................................ 4
  3324.  Memory Problems ...................................................... 33
  3325.  Memory Problems ...................................................... 34
  3326.  MENU.DAT ............................................................. 37
  3327.  Menus ................................................................. 2
  3328.  Minimum Column Width ................................................. 18
  3329.  Modify Existing File Size? ........................................... 11
  3330.  Modify FILE.DAT ...................................................... 37
  3331.  Monochrome Monitors .................................................. 39
  3332.  Mouse Installation Batch File ........................................ 40
  3333.  Mouse Systems Mouse .................................................. 40
  3334.  Move ................................................................. 21
  3335.  Move a Section of the Plot to a Different Location ................... 24
  3336.  Moved Images - Plotting .............................................. 27
  3337.  Name of File ......................................................... 11
  3338.  Number of x Values, Number of y Values for Each x Value .............. 10
  3339.  o Command ............................................................ 23
  3340.  Orientation .......................................................... 25
  3341.  Other Differences Between Screen and Plotter Graphics ................ 27
  3342.  P Command ............................................................ 23
  3343.  Paint a Region ....................................................... 23
  3344.  Paint Command - Plotting ............................................. 27
  3345.  Palette ............................................................... 7
  3346.  Pie Chart Menu ....................................................... 14
  3347.  Pie Chart Specifications ............................................. 14
  3348.  Pie Charts ........................................................... 11
  3349.  Pie Colors ........................................................... 15
  3350.  Place a Dot .......................................................... 21
  3351.  Plotting - Stopping .................................................. 26
  3352.  Position of Charts ................................................... 15
  3353.  Print Aspect Ratio ................................................... 25
  3354.  Printer/Plotter Menu ................................................. 25
  3355.  Produce Hard Copy Output ............................................. 24
  3356.  Restrictions and Special Features of Edit ............................ 27
  3357.  Retrieve a Screen from Disk .......................................... 23
  3358.  Retrieving Saved Plots ............................................... 26
  3359.  Return Key ............................................................ 3
  3360.  Running The Draftsman From a Floppy .................................. 37
  3361.  Running The Draftsman from a Hard Disk ............................... 38
  3362.  s Command ............................................................ 22
  3363.  
  3364.  
  3365.  
  3366.  
  3367.  
  3368.  
  3369.  
  3370. User Manual for The Draftsman 
  3371. ______________________________________________________________________________
  3372.  
  3373.  Sample Data File (Comma Delimited) ................................... 10
  3374.  Save Screen/Data/Spec ................................................ 28
  3375.  Save Screen/Data/Spec Menu ........................................... 28
  3376.  Screen ............................................................... 28
  3377.  Screen Aspect Ratio ................................................... 7
  3378.  Screen Not Readable - Solution ....................................... 39
  3379.  SCREENX.DAT File Names ............................................... 31
  3380.  Separating Multiple Values ............................................ 4
  3381.  Shading Patterns ..................................................... 17
  3382.  Size of Charts ....................................................... 15
  3383.  Slide Names .......................................................... 30
  3384.  Slide Show - Manual Control of Pace .................................. 30
  3385.  Slide Show Menu ...................................................... 30
  3386.  Some General Notes on Menus ........................................... 4
  3387.  Source Code Available ................................................ 41
  3388.  Source of Data ........................................................ 8
  3389.  Space Bar Command .................................................... 30
  3390.  Spec ................................................................. 28
  3391.  Specify Input ......................................................... 7
  3392.  Specify Input Menu .................................................... 8
  3393.  Stacked Bars ......................................................... 17
  3394.  Startup .............................................................. 27
  3395.  Step Size ............................................................ 21
  3396.  Storing Disks ........................................................ 35
  3397.  Support for Registered Users ......................................... 41
  3398.  Support for Users .................................................... 41
  3399.  Switch Settings ...................................................... 26
  3400.  The Draftsman Files .................................................. 36
  3401.  The Main Menu ......................................................... 5
  3402.  Time ................................................................. 30
  3403.  Title and Footnote Fields ............................................ 15
  3404.  Title, Footnote ...................................................... 17
  3405.  Unreadable Screens ................................................... 39
  3406.  Using Help ............................................................ 1
  3407.  VIO.DAT .............................................................. 37
  3408.  W Command ............................................................ 22
  3409.  w Command ............................................................ 22
  3410.  WORK.DAT ............................................................. 37
  3411.  Write Your Name in Longhand .......................................... 22
  3412.  Write-Protected ...................................................... 34
  3413.  x ..................................................................... 2
  3414.  X axis - meaning ..................................................... 10
  3415.  X-label .............................................................. 17
  3416.  Y axis - meaning ..................................................... 10
  3417.  Y column ............................................................. 15
  3418.  Y-columns ............................................................ 18
  3419.  Y-label .............................................................. 17
  3420.  
  3421.  
  3422.  
  3423.  
  3424.  
  3425.  
  3426.  
  3427.  
  3428.  
  3429.  
  3430.  
  3431.  
  3432.  
  3433.